diff --git a/doc/customizing-pandoc.md b/doc/customizing-pandoc.md
new file mode 100644
index 000000000..37b77cf1f
--- /dev/null
+++ b/doc/customizing-pandoc.md
@@ -0,0 +1,18 @@
+# Customizing pandoc
+
+## Templates
+
+## Reference docx/odt
+
+## Custom lua writers
+
+## Custom syntax highlighting
+
+syntax definitions, styles
+
+## Filters
+
+including documentation of the JSON serialization format and
+AST definition
+
+
diff --git a/doc/using-the-pandoc-api.md b/doc/using-the-pandoc-api.md
new file mode 100644
index 000000000..b567db968
--- /dev/null
+++ b/doc/using-the-pandoc-api.md
@@ -0,0 +1,28 @@
+# Using the pandoc API
+
+## Concepts
+
+## Basic usage
+
+## The Pandoc structure
+
+## Reader options
+
+## Writer options
+
+## The PandocMonad class
+
+custom PandocMonad instances
+
+## Builder
+
+example: report from CSV data
+
+## Generic transformations
+
+Walk and syb for AST transformations
+
+## Filters
+
+writing filters in Haskell
+