sphinxcontrib-pandoc-markdown¶
sphinxでマークダウンを扱う場合はrecommonmarkを使用する方法があります。
recommonmarkは拡張により数式やreStructuredTextを埋め込めるため非常に便利です。
しかし、以下のような欠点があります。
- CommonMarkが元なのでテーブル記法がない
- 拡張機能の設定方法が面倒
sphinxcontrib-pandoc-markdownは、pandocを用いてマークダウンを変換します。
そのため、pandocマークダウンの拡張記法を使用することができます。
recommonmarkと同様にソースパーサーですので、rstとmdを混在することができるため、設定を細かく指定したい文書はrstで、気軽に手早く書きたい場合はmdで書くなど使い分けが可能です。