Markdown を Word・PDF に変換する方法

Markdown を Word や PDF にするには Pandoc、拡張機能、オンライン変換、プレビュー印刷があります。それぞれの手順と崩れやすい点、LightNote の書き出しを紹介します。

公開日

Markdown のノートを Word 文書や PDF にする方法は 4 つあります。コマンドラインの Pandoc、エディターの拡張機能、オンラインの変換サービス、そしてプレビューの PDF 印刷です。この記事では、それぞれのやり方と、変換でよく崩れるもの(表、画像、数式、図、脚注)、そして LightNote が DOCX、ODT、PDF、HTML、LaTeX、EPUB に直接書き出す方法を説明します。

Pandoc で Markdown を Word や PDF に変換するには?

Pandoc は、この用途でいちばん広く使われている文書変換ツールです。無料のコマンドラインツールで、Windows、macOS、Linux で使えます。インストールしたら、Word への変換は 1 行です。

pandoc note.md -o note.docx

Pandoc は出力ファイルの拡張子から形式を判断します。.docx、.odt、.epub、.html、.pdf などです。いくつかのオプションで、たいていの場合をカバーできます。

オプション働き
--reference-doc=template.docx自分の .docx のスタイル、余白、用紙サイズ、ヘッダーを使います(.odt でも使えます)。学校や会社のひな形を適用するときの方法です。
--toc文書に目次を付けます(HTML などでは -s と併用します)。
--pdf-engine=xelatexPDF を作るプログラムを選びます。pdflatex、xelatex、lualatex、typst、weasyprint、wkhtmltopdf などを指定できます。
--resource-path=.:imagesノートが参照する画像をどこから探すかを Pandoc に伝えます(Windows ではパスの区切りに ; を使います)。

PDF の場合、Pandoc は自分でページを組みません。既定の経路は LaTeX を通るので、MiKTeX や TeX Live などのディストリビューションをインストールしておく必要があります。なければ PDF への変換は失敗します。--pdf-engine でエンジンを変えることもでき、たとえばずっと軽い Typst を指定できます。自分用の Word のひな形を作るには、pandoc -o my-template.docx --print-default-data-file reference.docx を 1 回実行し、できたファイルを開いてスタイルを調整し、--reference-doc に渡します。すべてのオプションは Pandoc のマニュアル(英語)にあります。

Markdown を PDF や DOCX にするほかの方法は?

  • エディターの拡張機能。VS Code には、開いているノートを PDF、HTML、画像に書き出す拡張機能があります(「Markdown PDF」や「Markdown Preview Enhanced」で検索します)。手軽ですが、多くは PDF を作るために内部でブラウザーエンジンを使っており、結果は拡張機能が自分のノートをうまく扱えるかどうかに左右されます。
  • プレビューを PDF に印刷する。エディターやブラウザーで Markdown のプレビューを開き、印刷 → PDF として保存を使います。いちばん速く、簡単なノートならうまくいきます。結果はプレビューのテーマを引き継ぎ、改ページはブラウザーに任されます。
  • オンラインの変換サービス。テキストを貼り付けるかファイルをアップロードして、結果をダウンロードします。使い捨てのファイルなら構いませんが、ノートの内容が自分で管理できないサーバーを通ります。仕事、個人的なノート、顧客の資料には、ローカルのツールを選んでください。

Markdown の変換で崩れやすいものは?

  • 表。セルに長い文章を入れた表は、LaTeX 経由の PDF でページの幅からはみ出します。結合セルやセル内のリストのような複雑な表は、標準の Markdown にはありません。
  • 相対パスの画像。![](images/chart.png) は、変換を正しいフォルダーで実行するか、--resource-path を渡したときにしか動きません。印刷したプレビューでは、フォルダーの外にある画像は単純に消えます。
  • 数式。LaTeX の数式($E = mc^2$)は、Pandoc なら Word の数式になりますが、印刷したプレビューでは、プレビューが描画できるときにしか表示されません。
  • Mermaid の図。コードブロックの中のテキストです。描画できない変換ツールは、図ではなく図のソースコードをそのまま書き出します。Pandoc では別にフィルターが必要です。
  • 脚注。たいてい Word でも PDF でも残りますが、変換ツールによって文書の末尾に来るか各ページの下に来るかが変わるので、位置を確認してください。
  • 特殊文字。LaTeX 経由では、フォントにその文字がないと、絵文字や一部の記号が抜け落ちることがあります。

どの方法でも、ファイルを人に送る前に、結果を開いて表、画像、数式を確認してください。

LightNote は Markdown を Word、PDF などにどう書き出しますか?

Windows と Linux で使える無料のノート・コードエディター LightNote は、アカウント不要で、ローカルのファイルを扱います。書き出しは組み込み済みで、Pandoc も LaTeX も要りません。ノートを開いた状態でファイル → ノートをエクスポート(またはタブ専用ツールバーのエクスポートボタン)を使い、書き出し先を選びます。Word、OpenDocument、LaTeX、Typst、EPUB は LightNote 自身が書き出すので、何もインストールする必要はありません。それぞれの内容は次のとおりです。

  • DOCX と ODT:見出し、リスト、表、脚注、画像、そして編集できる数式(Word の数式、LibreOffice の Math)が入ります。Mermaid の図と化学構造は画像として入ります。
  • PDF:読み取りモードと同じドキュメントから作られ、目次とトランスクルージョンが含まれます。ベクターのテキストなので検索できます。テーマがダークでも、PDF は常に明るい用紙で出ます。
  • HTML:自己完結した 1 つのファイル(ローカルの画像は埋め込み)で、数式は本物のテキストである MathML です。
  • LaTeX(.tex):完全なプリアンブル付きで、pdfLaTeX、XeLaTeX、LuaLaTeX でコンパイルできます。フォルダーに書誌があり、学術セクションが有効なら、引用が生きた形(\autocite)で出て、ファイルの隣に refs.bib が書き出されます。
  • Typst と EPUB:Typst は LaTeX の軽い代替です。EPUB はレベル 1 の見出しごとに 1 章になります。

オプションを指定してエクスポート...を選ぶとダイアログが開き、すべての書き出し先が一覧になって、選んだ書き出し先に効くオプションだけが表示されます。ノートの先頭に付ける目次、文書の言語、引用、PDF の用紙(A4 またはレター)、Word のひな形などです。大学や会社の Word のひな形を使うには、ワークスペースの設定 → 引用と参考文献 → Word のひな形にその .docx を指定します。書き出されたファイルは、ひな形のスタイル、用紙、余白、ヘッダーで出ます。書き出し先に対応するものがないノートの内容があるときは、書き出しの最後に LightNote が知らせます。例外は RTF で、こちらは Pandoc を通ります。その形式が必要なときは、LightNote がインストールを勧めます。

フォルダー全体も書き出せます。ファイル → フォルダーを書き出す...で、ノートが HTML サイト、または .docx や .odt のセットになり、ノート間のリンクも書き出し先に合わせて直されます。

ファイル → 印刷…(Ctrl+P)は、余白、改ページ、ページ X / Y のフッターを含むページ分割されたプレビューを開き、読み取りモードの表示を再現します。学術論文では、設定 → 機能 → 学術 → 学術論文の書式 (規格) で機能をオンにし、使う規格をツール → 学術論文の規格からダウンロードします(一覧には ABNT NBR 14724、APA 7、Chicago/Turabian、ISO 7144 があります)。規格は、審査で確認されるページの形(余白、フォント、行間、見出し、キャプション、番号)を、PDF、印刷、Word、Typst に与えます。Word では、ファイルを開くときにフィールドを更新するか尋ねられるので、承諾すると目次にページ番号が表示されます。

LightNote は無料で軽量、Windows と Linux で動きます。アカウント不要で、ファイルをどこにも送りません。

LightNote をダウンロード

ほかの記事

← すべての記事