Markdownで書いた文書を、PDFにして送らなければならない。どこで開いても同じ見た目で、印刷してもきれいな形式です。このページでは、.md ファイルからきちんとしたPDFを作るいちばん簡単な道すじを、ヘッダ、フッタ、ページ番号、余白まで自分で決められる形で説明します。
記法そのものが初めてなら、Markdownガイドに一式あります。ここでは、その先に出てくるものの話をします。
いちばん簡単な方法：書き出せるエディタで書く
見栄えのするPDFを確実に作るなら、ライブプレビューがあって直接書き出せるMarkdownエディタでファイルを書くか、開くのがいちばんです。利点は、見えているものがそのまま出てくることです。PDFは整形されたプレビューと一致します。同じテーマ、同じフォント、同じ表、同じコードブロック。開いてから驚くことがありません。
Mac、iPad、iPhoneのInkiostroなら、流れはこうです。
- Markdownを開くか貼り付ける。 どの
.mdファイルでも構いませんし、白紙から書き始めても構いません。 - ライブプレビューに切り替えて、整形された文書を確かめます。見出し、リスト、表、画像、コードまで全部です。
- 書き出し → PDF を選ぶ。
- ページを整える。 タイトルを付け、ヘッダとフッタを入れ、ページ番号を出し、余白を好みに合わせます。
- 書き出して渡す。 ファイルを保存するか、メール、メッセージ、AirDropにそのまま送ります。
PDFは選んだ読書テーマとフォントを引き継ぐので、そっけない最小限の文書から、本のように温かいページまで、レイアウトソフトに触れずに作り分けられます。
よい書き出しが守るべきもの
変換ならどれでも同じ、ということはありません。質のいい書き出しは、Markdownが表しているものを全部残します。
- 見出しと構造。 文書がアウトラインとして読めること。
- 表。 パイプの列ではなく、表として組まれること。
- コードブロック。 等幅のまま、シンタックスハイライトつきで。
- 画像。 適切な大きさで埋め込まれること。
- リンク。 PDFの中でも押せること。
- 数式と図。 文書に入っているなら、MarkdownのLaTeX数式とテキストから作る図も一緒に。
ページの体裁を決める
「PDFに吐き出しただけ」ではなく、意図のある文書に見せたいなら、ページそのものを設定します。
- タイトル — 1ページめに置く文書のタイトル。
- ヘッダとフッタ — 上下にくり返し入る文字。タイトルや自分の名前など。
- ページ番号 — 数ページを超えるなら必須です。
- 余白 — 文字のまわりの空白を、詰めるか広げるか。
Inkiostroではどれも、PDF書き出しの設定項目です。一度決めておけば、毎回そろった仕上がりになります。
ほかの変換方法
- コマンドライン（Pandoc）。 開発者ならPandocのような道具でまとめて変換できます。強力ですが、導入と設定が要りますし、体裁を思いどおりにするには手間がかかります。
- ブラウザから印刷する。 エディタがHTMLを書き出せるなら、それを開いて「プリント → PDFとして保存」でも作れます。できはしますが、ヘッダや余白、改ページの制御はかなり弱くなります。
たいていの人にとっては、Markdownエディタからそのまま書き出すほうが速く、見た目もよく、しかもプレビューと同じものが出てきます。
きれいなPDFにするコツ
- 先にプレビューを見る。 整形の崩れは、書き出す前の表示で直しておきます。
#の見出しを1つだけ文書のタイトルに使い、その下を##と###で組み立てます。PDFの階層がはっきりします。- 画像には代替テキストを付け、大きすぎないか確かめます。
- 読み手に合った読書テーマを選ぶ。 報告書ならそっけないもの、読み物なら温かいものを。
試してみますか。InkiostroはPDF、HTML、TXT、Markdownに書き出せます（MacではEPUBも）。無料で、アカウントも要らず、透かしも入りません。Mac向けのMarkdownエディタとしてどうなのかは、こちらにまとめてあります。
よくある質問
MarkdownファイルをPDFにするには？
PDF書き出しのあるMarkdownエディタで .md ファイルを開き、ライブプレビューで整形を確かめてから、書き出し → PDF を選んで、ヘッダ、フッタ、ページ番号、余白を決めます。InkiostroならMac、iPad、iPhoneでできます。
PDFはプレビューとまったく同じ見た目になりますか？
よいエディタならなります。InkiostroのPDFはライブプレビューと一致します。同じテーマ、同じフォント、同じ表、同じコードの体裁です。書き出した文書は、画面で見たそのものです。
ページ番号やヘッダは付けられますか？
付けられます。InkiostroのPDF書き出しでは、タイトルを設定し、ヘッダとフッタを入れ、ページ番号を有効にし、余白を調整してから書き出せます。
無料でPDFにできますか？
できます。InkiostroのPDF書き出しは無料で、アカウントも要らず、出力に透かしも入りません。
表やコードや画像は残りますか？
質のいい書き出しなら全部残ります。表は表として組まれ、コードブロックは等幅とハイライトのまま、画像は埋め込まれます。エディタが対応していれば、数式と図も一緒に付いてきます。