MarkdownをPDFに変換するには？
上のボックスに.mdファイルを入れてください。ブラウザが記法を読み取り、整ったレイアウトに組み直して、ダウンロードできるPDFを作ります。コマンドラインツールやエディタのプラグインは必要ありません。元のMarkdownファイルには一切手を加えないので、文章を書き直したら何度でも変換し直せます。
仕上がりはファイルの構成どおりになります。シャープ記号1つで始まる行がいちばん大きな見出しに、2つで始まる行が章見出しに、というように順に小さくなります。行頭のハイフンや数字はリストに、アスタリスクで囲んだ語は太字や斜体になり、フェンスで囲んだコードはスペースを保ったまま表示されます。
ヒント： 文書のタイトルとして最上位の見出しを1つだけ書き、各章は2番目の見出しで区切りましょう。PDFが手順のはっきりした、読みやすい文書になります。
そもそもMarkdownをPDFにする理由は？
Markdownは書くには快適ですが、そのまま人に渡すには不向きです。簡単なビューアで.mdファイルを開くと、読み手には完成したページではなく、シャープ記号やアスタリスク、バッククォートが並んで見えます。Markdownを表示できるアプリを持っていない人も多く、メールの添付や申請フォームでは拡張子ではじかれることもあります。
PDFは、Markdownで表したかった文書そのものです。どの端末でも同じ見た目で表示され、きれいに印刷でき、どこにでも添付できます。取引先に渡す技術資料、同級生と共有する勉強のまとめ、紙でじっくり確認したいREADMEなど、誰でも開ける形式にしたいときはPDFが確実です。社内のWikiや個人のノートに書きためた内容を、会議の配布資料としてまとめる用途にも向いています。
変換したPDFはどう活用できますか？
- ページ番号を付ける。 長めの文書なら、ページ番号を追加すると読み手が今どこを読んでいるか分かりやすくなります。
- ほかのファイルと結合する。 変換したメモに表紙や別の資料をまとめて、1つのPDFにできます。
- 下書きであることを示す。 回覧する前に「下書き」や読み手の名前を透かしとして全ページに入れられます。
- 容量を小さくする。 メールで送るなら、PDF圧縮ツールで余分なデータを減らせます。
- 印刷する。 長いREADMEや仕様書も、余計な表示のない紙の資料として確認できます。
MarkdownをオンラインでPDFにしても安全？
安全です。使うのはWebページですが、整形とPDFの作成はお使いのブラウザの中で行われます。ファイルは端末内で読み込まれ、メモリ上でレイアウトされ、ダウンロードとして手元に戻ってきます。アップロードは一切しないので、公開前のドキュメントや顧客とのメモ、個人的な日記がサーバーに届くことはありません。
変換中にブラウザの開発者ツールでネットワークタブを見れば、ご自身で確認できます。ファイルのデータは外に出ていかず、本文に埋め込まれた外部画像を取りに行くこともありません。インストールもアカウント作成も不要で、タブを閉じればページ上から文章も消えます。
日本語のMarkdownもきれいに変換できますか？
はい。日本語を含むファイルを変換すると、日本語を表示するための小さなフォントデータが必要なときだけダウンロードされ、PDFに組み込まれます。ページを開いただけでフォントを読み込むことはないので、英語だけの文書なら余計な通信は発生しません。用紙サイズはA4、レター、リーガル、Folioから選べるので、日本の職場で使う資料ならA4を選んでおけば、そのまま社内のプリンターやコンビニのネットワークプリントで印刷できます。