mkdocs is pretty easy and simple too: pip install --user mkdocs cd your-markdown-directory/../ echo 'site_name: mysite' > mkdocs.yml ln -s your

mkdocs is pretty easy and simple too: pip install --user mkdocs cd your-markdown-directory/../ echo 'site_name: mysite' > mkdocs.yml ln -s your-markdown-directory docs mkdocs build && mkdocs serve # if you don't like the default theme: mkdocs build -t readthedocs && mkdocs serve No you do not need add special meta info into your markdown files, any regular markdown files will work just fine.