Markdown → Word / PDF 変換

md から Word・PDF への変換について

なぜ Markdown を書き出す必要があるのか

Markdown は書くのに向いていますが、提出に向いているとは限りません。書き終えたあと、相手が求めるのはたいてい .docx です。コメントを入れたい、変更履歴を使いたい、組織の書式テンプレートに流し込みたい、あるいは単に手続き上 Word しか受け付けない、といった事情があります。週報、要件定義書、入札書類、課題レポートはいずれもこの類です。変換の意味は拡張子を変えることではなく、プレーンテキストの記法を Word が理解できるスタイルに変えることにあります。見出しは目次を生成できるアウトラインレベルになり、箇条書きは本物の段落番号になり、表は列幅を調整できる表オブジェクトになります。

Word と PDF、どちらにするか

まだ手を入れる、相手にコメントをもらう、変更履歴のフローに乗せる——そうした場合は Word にします。すでに確定していて、送付・印刷・保管に回すなら PDF です。PDF はどのパソコンでもレイアウトが変わらず、相手にフォントが入っていなくても行が崩れず、うっかり書き換えられることもありません。実務では、まず Word で書き出してレビューを回し、最後に確定版として PDF を出す進め方がよく使われます。このページはどちらの形式にも書き出せるので、同じ Markdown を 2 回変換すれば済みます。

オンライン変換と Pandoc の使い分け

この種の変換の定番は Pandoc です。テンプレート、参照スタイル、相互参照、参考文献まで制御でき、ドキュメントのパイプラインを長期的に維持する用途に向いています。その代わり、インストールし、LaTeX 環境を整え、オプションを覚える必要があります。手元のこの 1 ファイルを提出したいだけなら、そのために環境を作るのは割に合いません。このページはブラウザ内で変換を完結させ、インストールも登録も不要で、ファイルがパソコンの外に出ることもありません。長期的な自動化が必要になった時点で Pandoc に移っても遅くはありません。

変換で崩れやすい書き方

Markdown に直接書いた生の HTML、深く入れ子になった表、独自の CSS は、Word や PDF に対応する構造がないため、変換時に簡略化されます。数式や Mermaid の図のように特定のレンダラーに依存する拡張記法は、元のプラットフォームと同じ見た目にはなりません。ローカルディスクの画像を参照する書き方も画像を取得できません。ブラウザは同じフォルダにある他のファイルを読めないので、画像の URL に置き換えてください。変換前にプレビューで一度確認してください。そこで見えているものが、書き出される結果に近いものです。