ドキュメント、マニュアル作成というと、その作業量、メンテナンス性に圧倒され、開発者でなくとも眉をひそめる作業だと思います。 最近は、 MarkdownText というイージーなドキュメント書式がOSS界隈で流行ってますが、 Markdown書式を少し拡張しつつhtml化したときに任意のテンプレートを適用することが出来れば、記事作成も捗ります。 今回は、見た目と可搬性の両立をするためにドキュメント変換ツール pandoc を用いて その問題を解決してみました。 以下だらだらと説明が続きますが、さっさと使わせろ!という方は、記事一番下のGitHubリンクをお試しください。 pandoc でhtmlを生成するチュートリアル まずはpandocをインストール 以下ページから各OS用のバイナリがダウンロードできます。 http://johnmacfarlane.net/pandoc/installi