MoinMoinでMarkdownを使う

Markdown と、その拡張記法である Github Flavored Markdown (GFM)、および Markdown Extra を使いたい。
Python 用の Markdown パーサー (python-markdown) があるのでそれをそのまま使うことにする。

MoinMoin側プラグイン

既に MoinMoin 用に、python-markdown に丸投げするパーサープラグイン (Markdown Parser) がある。
これを一部改変して使う。

Markdown/改変済みパーサー

変更点

パーサーに渡す引数を wikiconfig.py 中で指定できるようになった (markdownargs = {‘option’: ‘value’, })

デフォルトで html タグをエスケープするようにした (safe_mode=’escape’)

python-markdown の設定

python-markdown は Extension で機能を拡張/変更することができる。
これを使って GFM 対応等々の拡張を施す。

記法の拡張

GFM, Markdown Extra を導入したい。

GFM について

• Standard Markdown との違い 1
• 違い 2
• 記法チートシート

Markdown Extra について

• Standard Markdown との違い

GFM

python-markdown の extension である py-gfm を導入する。

適当な場所にレポジトリを clone する。

git clone https://github.com/dart-lang/py-gfm.git

clone したレポジトリへのパスを sys.path に追加して import できるようにする。
例えば、wikiconfig.py にそのように追記する。

    sys.path.insert(0, 'path/to/py-gfm')

参考記事

• MoinMoin で Markdown (Github Flavored Markdown) を使う (tototoshi の日記)
• Python で Github Flavored Markdown をレンダリングする (tototoshi の日記)