<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