experimental implementation to use markdown as input of Sphinx.
install remarkdown
$ pip install https://github.com/sgenoud/remarkdown/archive/master.zip $ curl -LO https://raw.githubusercontent.com/sgenoud/remarkdown/master/remarkdown/markdown.parsley $ mv markdown.parsley lib/python2.7/site-packages/remarkdown
- put sphinxcontrib_markdown.py to your environment
configure your sphinx project (conf.py)
Add following settings to `conf.py`:
sys.path.insert(0, '.') extensions.append('sphinxcontrib_markdown') source_suffix = '.md'
- write index.md!
This is great. remarkdown seems to be breaking on raw HTML snippets though. But it's a great start! :)