#format text_markdown

# MoinMoinでMarkdownを使う

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

[1]: http://daringfireball.net/projects/markdown/syntax
[2]: https://help.github.com/articles/github-flavored-markdown
[3]: http://michelf.ca/projects/php-markdown/extra/

## MoinMoin側プラグイン

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

[[Markdown/改変済みパーサー]]

変更点
: パーサーに渡す[引数](http://pythonhosted.org/Markdown/reference.html)を wikiconfig.py 中で指定できるようになった (markdownargs = {'option': 'value', })
: デフォルトで html タグをエスケープするようにした (safe_mode='escape')

## python-markdown の設定

python-markdown は [Extension](http://pythonhosted.org/Markdown/extensions/index.html) で機能を拡張/変更することができる。
これを使って GFM 対応等々の拡張を施す。

### 記法の拡張

GFM, Markdown Extra を導入したい。

GFM について

- [Standard Markdown との違い 1](https://help.github.com/articles/github-flavored-markdown)
- [違い 2](https://help.github.com/articles/writing-on-github)
- [記法チートシート](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet)

Markdown Extra について

- [Standard Markdown との違い](http://michelf.ca/projects/php-markdown/extra/)

#### GFM
python-markdown の extension である [py-gfm](https://github.com/dart-lang/py-gfm) を導入する。

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

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

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

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



参考記事

- [MoinMoin で Markdown (Github Flavored Markdown) を使う](http://tototoshi.hatenablog.com/entry/2014/05/14/023149) (tototoshi の日記)
- [Python で Github Flavored Markdown をレンダリングする](http://tototoshi.hatenablog.com/entry/2014/05/17/020241) (tototoshi の日記)