Markdown で書いた文書にシンタックスハイライトした形でソースコードを掲載したいと考えています。Pygments 等のツールを使って Markdown 中のコードをハイライトするにはどうすれば良いでしょうか?
コマンドラインで動作する Markdown→HTML 変換ツールでシンタックスハイライトができるようなツールがあれば教えていただきたいです。またできれば GitHub-flavored Markdown が扱えればなお嬉しいです。
よろしくおねがいします。
Grip - Github Readme Instant Preview を使ってみるのはどうでしょうか.
以下のコマンドを実行してインストールし,
% pip install grip
以下のコマンドを実行すると Github-flavored Markdown なファイル (file.md
) が HTML (file.html
) に変換されます.文章中のソースコードは Pygments によってシンタックスハイライトされます.
% grip --export --gfm file.md
補足:
--export
オプションを指定しない場合は,localhost:5000
を Web ブラウザで開くことで変換後の内容を閲覧できます.--export
オプションによる .md -> .html 変換が正常に実行できませんでした.Python 2.7 では正常に動作しました.Python-markdownとPygmentsの組み合わせであれば、こんな感じでしょうか。
$ python -m markdown -x cod hoge.md > hoge.html
$ pygmentize -S default -f html > code.css
あとはhoge.html
に<link rel="stylesheet" href="./code.css" type="text/css" media="all" />
を入れれば、カラーで表示されるようになると思います。
まあPygmentsに拘らなければGripかPandocの方がラクな気がしますが…。