diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1db3175
--- /dev/null
+++ b/README.md
@@ -0,0 +1,26 @@
+# Inner Teapot vimwiki
+
+This repo contains the contents of my tilde.down vimwiki which also generates my town web site.
+
+## Requirements
+
+- vim
+- vimwiki plugin
+- vimwiki_markdown (installed via pipx)
+
+## Configuration
+
+```
+let g:vimwiki_list = [{'path': '~/vimwiki/',
+                      \ 'syntax': 'markdown',
+                      \ 'ext': '.md',
+                      \ 'path_html': '~/public_html',
+                      \ 'template_path': '~/vimwiki/templates/',
+                      \ 'template_default': 'default',
+                      \ 'template_ext': '.tpl',
+                      \ 'custom_wiki2html': 'vimwiki_markdown'}]
+let g:vimwiki_global_ext = 0
+
+map <leader>D :put =strftime('# %Y-%m-%d')<CR>
+```
+