MPS 世田谷での発表資料です。

1. ⻫藤 博⽂ (hi̲saito@yk.rim.or.jp)
1 / 14

2. 1 ⾃⼰紹介
2 作成したもの
3 今回の目標
4 メリット
5 補⾜
6 使うもの
7 Pandoc
8 Pandoc のメリット
9 Markdown から HTML
変換
10 次回
2 / 14

3. テキストファイル処理に興味があり、AWK や Shell などで雑多な
プログラミングをしています。
⽇本 GNU AWK ユーザー会会⻑、USP 友の会幹事
Twitter: @hi̲saito
Facebook: /hirofumi.saito.33
auk (ペンギン) のアイコンを⾒かけたら私です。
3 / 14

4. ⾃分の満⾜のために作成しているので公開しているものはありませ
んが、以下のようなものを作成しています。
サーバーから iPhone へのプッシュ通知
コンテンツブロッカー Proxy
Markdown から社内⽂書の作成
今回は Markdown から⽂書を作成していきます。
4 / 14

5. MS Office や LibreOffice を使わずに Markdown から実⽤に耐え
る⽂書 (HTML) を作成していきます。
HTML っぽくない体裁 … CSS3 で対応
図表番号や相互参照 … スクリプトで対応
ヘッダーやフッター … Vibliostyle.js1
単なる変換作業だけでなく周辺技術も学んでいきます。
5 / 14

6. HTML そのものを印刷に耐えられる体裁にすることには以下のよう
なメリットがあります。
Markdown の流⾏
Web ページと印刷物の共通化
局所的な体裁の禁⽌
印刷して読みやすいものは Web でも読みやすいのです。
6 / 14

7. このスライドも Markdown でできていて、スライド⽤も印刷⽤も
同じ Markdown のソースから作られています。
余計な⼿間の削減
⽂書管理の簡略
スマホでも作成可能
iOS なら Writebox が無料で便利です。
7 / 14

8. ここでは以下のものを使います。ここに挙げたものは Windos,
MacOS, Linux で同じように使えます。
Pandoc
Web ブラウザ (Chrome or Firefox)
AWK … 得意な⾔語で構いません
他に⾃分の使いやすいエディタがあると便利です。
8 / 14

9. Pandoc をインストールします。ここでは Windows を前提にして
いますが、MacOS や Linux でもパッケージが⽤意されています。
Pandoc2
Pandoc - Installing3
インストーラーが⽤意されているので簡単です。
9 / 14

10. Pandoc 以外にも Markdown を HTML に変換するツールはありま
すが、Pandoc は以下の点で優れています。
Markdown や HTML 以外の多くの⼊出⼒フォーマットに
対応
Windows, MacOS, Linux に対応
雛型を指定することができる
⽂書フォーマット変換ソフトを持っておくと便利です。
10 / 14

11. 11 / 14

12. Windows のコマンドプロンプトを起動して以下のように実⾏する
ことで HTML が⽣成できます。
Code 9-1: Pandoc の実⾏
$ pandoc foo.md -o foo.html
しかも⾼速に変換します。
12 / 14

13. 次回は Markdown と Pandoc について深掘りします。
Markdown の書式
Pandoc を使った変換
Markdown で⾜りない部分
乞うご期待。
13 / 14

14. Vibliostyle.js: http://vivliostyle.co.jp/wp/project/1.
Pandoc: http://pandoc.org/2.
Pandoc - Installing: http://pandoc.org/installing.html3.
14 / 14