Markdown形式(そこまで複雑でないが長いもの)で書いたドキュメントを、HTMLにしてS3でホストしたりPDFで配布したい のでSphinxを試しました。 (プログラミング始め1年あまり、Pythonしか手に馴染んでる言語がない、というのもありますが……) 形にはなっているものの、少し見栄えが悪いのが難点で、最適解模索中です。 インストール Sphinx 本体と、Markdown(正確にはcommonmark)形式のパーサー、Sphinxで扱う形式への変換モジュールをインストールします。 2017/3 初旬現在、commonmarkの最新版とrecomonmarkの相性が悪いため、前のバージョンを指定してインストールをします。 参考:SphinxでMarkdownを使うときに注意すること 設定 ソースディレクトリに置かれるconf.pyに記述を追加します。 from recommonm