2015/11/25 Sphinx でMarkdown を使う( 仮) https://dl.dropboxusercontent.com/u/218108/sphinxcon2015/markdown.html#1 5/12 pip でインストー ル / Install via pip 必要なソフトをインストー ル p i p i n s t a l l S p h i n x c o m m o n m a r k r e c o m m o n m a r k
2015/11/25 Sphinx でMarkdown を使う( 仮) https://dl.dropboxusercontent.com/u/218108/sphinxcon2015/markdown.html#1 6/12 conf.py conf.py の以下の行 s o u r c e _ s u f f i x = ' . r s t ' を以下のように変更するだけ s o u r c e _ s u f f i x = [ ' . r s t ' , ' . m d ' ] s o u r c e _ p a r s e r s = { ' . m d ' : ' r e c o m m o n m a r k . p a r s e r . C o m m o n M a r k P a r s e r ' , }
2015/11/25 Sphinx でMarkdown を使う( 仮) https://dl.dropboxusercontent.com/u/218108/sphinxcon2015/markdown.html#1 7/12 使い方 / How to use markdown をrst と同じようにtoctree に組み込むだけ . . t o c t r e e : : : m a x d e p t h : 2 m a r k d o w n F i l e r e s t F i l e ファイル単位で 混合 もOK 通常はMarkdown で記述し、 複雑な表現が必要ならばreST で記述 ということも可能