[Document & Workflow] Markdownをめぐる私的メモ
memo.
[markdown]
* Markdown on Save Improved
* GitHub Flavored Markdown for WordPress (おすすめ)
* StackEdit
[/markdown]
[markdown]
どこかに書いたつもりで書いていなかったので、とりあえずメモ。
## Markdown on Save Improved
> * [WordPress › Markdown on Save Improved « WordPress Plugins](http://wordpress.org/plugins/markdown-on-save-improved/)
### good
公式で配布されているプラグインをいくつか試したが一番こなれていた。
投稿編集画面に追加されるこのチェックボックスが肝で、Markdown format を off にもできるし、既存の HTML format を Markdown に変換することもできる。
既存の記事は、Disable Markdown formatting が on の状態になり、HTML のまま編集・保存を行っても影響を及ぼさない。（プラグインによっては内容が書き換わり、Markdown と HTML のカオスとなり記事が壊れることがあった。）
DB には HTML に変換された内容が保存されており、プラグインを停止しても閲覧・編集とも問題を起こさなかった。
### bad
bad というか、運用上、個人的に困っているという話。
例えば code block に利用する three backticks が使えないようなので困っている。
\`\`\` こういうのを three backticks っていうんですね。
### Markdown on Save Improved 2
追記 2013/10/11
[Markdown on Save Improved](http://wordpress.org/plugins/markdown-on-save-improved/installation/) の作者さんとは違うようなのですが、[zmax/markdown-on-save-improved-2 · GitHub](https://github.com/zmax/markdown-on-save-improved-2)をつかうと、上記のような Github fenced code block に対応してくれるそう。
Crayon syntax highlighter で装飾されるみたいです。
> * [WordPressのプラグイン整理 | しあわせあたま](http://ohton.firebird.jp/dnf/archives/1571)
olthonさんに教えて頂きました。ありがとうございます。
## GitHub Flavored Markdown for WordPress
Note
Crayon Syntax Highlighter Ver.2.5.0 にしたところ、表示が乱れるようになりました。
なにかぶつかっているのかも。
Crayon Syntax Highlighter を止めました。
> * [makotokw/wp-gfm](https://github.com/makotokw/wp-gfm)
blog の下書きに [Kobito](http://kobito.qiita.com/) を使っているが、このプラグインの作者さんも使っているようで、試してみたらやりたいことがカバーされているよう。
このエントリーから使ってみることにする。
Markdown on Save Improved との併用については、上記チェックボックスで Disable Markdown formatting をチェックすることで不具合はなさそう。
GitHub Flavored Markdown for WordPress のみが機能する状態になると思われる。
### google-code-prettify を適用する
追記(2013/09/20)
生成されたコードを確認すると pre タグの class に prettyprint が設定されていました。
google-code-prettify を使えるのかと、早速設定してみる。
> * [GettingStarted – google-code-prettify – How to style code in your web-pages – syntax highlighting of code snippets in a web page – Google Project Hosting](https://code.google.com/p/google-code-prettify/wiki/GettingStarted)
skin パラメータ付きのこちらを WordPress のヘッダーに追加する。
“`
“`
↑この通り、めっさ快適です。ありがとうございます。
## StackEdit
> * [超シンプルで高機能なMarkdownエディタの『StackEdit』がいい感じ！ | バンクーバーのうぇぶ屋](http://webya.opdsgn.com/webservice/markdownstackedit/)
こちらで紹介されていたブラウザから利用するWebアプリ。
> * [benweet/stackedit](https://github.com/benweet/stackedit)
Markdown形式で書いたドキュメントをいろいろなサービスに保存できるよう。
> * [StackEdit – Welcome document](http://benweet.github.io/stackedit/)
ここから利用するよう。
ブラウザで使わなければならないのが、個人的にはつらそう。
どんな風に利用しているのかレポート待ち。
[/markdown]