nDiki : GitHub Flavored Markdown

GitHub Flavored Markdown (GFM)

GitHub が使っている Markdown 方言。

テーブル や、 ``` で挟むことでコードブロックを書くことができる fenced code blocks や URL 自動リンク(URL autolinking) 他の拡張がされている。

スポンサード リンク

2014年7月10日 (木)

Emacs markdown-mode 設定していなかったので設定した

Markdown ファイルに色がつくだけでもまず良い。

公式サイトから markdown-mode.el をダウンロードし、設定ファイルに

 (autoload 'markdown-mode "markdown-mode"
     "Major mode for editing Markdown files" t)

 (add-to-list 'auto-mode-alist '("\\.markdown\\'" . markdown-mode))
 (add-to-list 'auto-mode-alist '("\\.md\\'" . markdown-mode))

としておけばまずは OK。standard Markdown (SM) ではなく GitHub Flavored Markdown (GFM)*1 で書いているならば markdown-mode のかわりに gfm-mode を使う。

外部コマンドを呼んで HTML ファイルに変換して preview とかする機能もあるのだけれど特に使うことなさそうなのでスルー。

スポンサード リンク
[ 7月10日全て ]

2014年7月30日 (水)

Text::Markdown::Discount でテーブルや ``` や自動リンクなどの拡張を使う

最近ノートやちょっとしたドキュメントは Markdown で書いて、Plack::App::Directory::Markdown (記事) (に手を入れて grep 検索や recent リストを表示できるようにした) Markdown ビューアで参照したり、関係者に見せたりしている。

重宝しているんだけれど、内部で使っている Text::Markdown Perl モジュールは、テーブルや GitHub Flavored Markdown にある fenced code blocks (``` で挟むやつ) が使えないのでちょっと不便になってきた。

Text::Markdown::Discount Perl モジュールはこの辺の拡張が使えるので、こちらに切り替えることにした。

このモジュールは discount というC言語書かれた Marrkdown 処理コードを使うもので、Text-Markdown-Discount 内に同梱されている。

そのままインストールすると fenced code blocks が有効になっていないので以下のようにしてインストールする。

 $ tar zxvf Text-Markdown-Discount-0.11.tar.gz
 $ cd Text-Markdown-Discount-0.11

 ここで Makefile.PL 中の

   qq{( cd $extdir; CC='cc -fPIC' sh configure.sh; make )\n}

 を

   qq{( cd $extdir; CC='cc -fPIC' sh configure.sh --with-fenced-code; make )\n}

 に変更する。

 $ cpanm .

で Text::Markdown::markdown() のかわりに Text::Markdown::Discount::markdown() を使うようにすれば OK。

なお自動リンクをしたい時には

 my $html = Text::Markdown::Discount::markdown($markdown_text,
   Text::Markdown::Discount::MKD_AUTOLINK);

のようにオプションを指定してあげる。

[ 7月30日全て ]

About Me

Naney Naney (なにい)です。株式会社ミクシィの SNS の企画開発を行うグループでマネージャー・プロダクトオーナーをしています。CS 向上・ユーザーサポート・健全化などにも取り組んでいます。

nDiki1999年1月に始めたコンピュータ日誌を前身とする NaneyWeb 日記(兼パーソナルナレッジベース)です。ちょっとしたノートは nNote にあります。

※内容は個人的見解であり所属組織とは関係ありません。

月別インデックス
Process Time: 0.117595s / load averages: 0.79, 0.67, 0.65
nDiki by WATANABE Yoshimasa (Naney, Google profile)
Powered by DiKicker