<Sphinx, Markdown> スフィンクスでマークダウン。

スフィンクスSphinxでマークダウンMarkdown

ReSTを覚えるのが面倒、、と思っていたら、できるんだ。
ちとインストールから始めないといけなかったけど。

>conda install Sphinx
>pip install recommonmark    # condaにはなかった。   

で、conf.pyを少し書き換える。

from recommonmark.parser import CommonMarkParser
source_parsers = {'.md': CommonMarkParser}  
source_suffix = ['.rst', '.md']

最初からパッケージに組み込んでおいてもらえるとな、、、 とちと思った。

ここを参考にした。

はじめに — Read The Docs 1.0 ドキュメント

Read the Docs & Sphinx now support Commonmark — Read the Docs Blog

参考。ReST vs Markdown

Pandoc Markdown and ReST Compared