MarkdownをWordに変換：オンライン・PandocとDOCXの確認

MarkdownからDOCXへ変換する方法を選ぶ

必要な作業	始め方	確認する点
インストールせずに1件変換する	ブラウザの変換ツール	保存後の見出し、セル、リンク
多数の文書を同じ手順で処理する	Pandocと自分で管理するスクリプト	入力形式、オプション、代表例の出力
Wordのスタイルを参照する	Pandocと参照用DOCX	見出しスタイル、フォント、表の見た目
複雑なレイアウトを仕上げる	構造を変換してWordで調整する	改ページ、画像配置、結合セル、ヘッダー

MDFormatsの文書処理はブラウザ内で行われます。ただし、文書に外部画像があれば、プレビュー時にその参照先へ通信することがあります。ローカル処理が、すべての素材のオフライン利用を意味するわけではありません。Pandocも参照した素材を取得する場合があるため、機密文書では画像やリンクも確認してください。

どちらを使っても、受け手のアプリやフォントによって改行・改ページは変わり得ます。プレビューだけで最終的な体裁を判断しないようにします。

照合しやすい短い原稿を用意する

次の原文をUTF-8でreport.mdとして保存するか、変換画面へコピーします。管理番号は先頭のゼロやセルの対応を確かめるためのものです。リンクは説明用で、実際の業務資料ではありません。

# 資料の引き継ぎ

配布前に **確定版** を確認します。

## 確認記録

| 資料 | 管理番号 | 状態 |
| --- | --- | --- |
| 操作手順 | DOC-0017 | 確認済み |
| テスト項目 | QA-0023 | 追記待ち |

## 配布前の作業

- Markdownの原稿を残す
- 保存したWord文書を開く

`npm run build`は該当するプロジェクトでのみ実行します。

[説明用リンク](https://example.com/docs)

見出し行を含めて3行3列の表です。npm run buildはインラインコードの表示を調べるための文字列なので、この手順のために実行する必要はありません。最初は番号、ファイル名、Markdownの記号をそのまま使うと、変換による変化を見つけやすくなります。

ブラウザで変換し、保存したDOCXを確認する

1. MarkdownからWordへの変換に原文を貼り付けるか、report.mdを読み込みます。
2. 2段階の見出し、表、独立した2つのリスト項目をプレビューで確認します。表が区切り記号の文字列になっていたら、先に原文を直します。
3. DOCXのダウンロード操作を選び、ファイルを保存します。
4. Wordなど、受け手が使うアプリで開きます。
5. QA-0023のセルを選び、文字を編集してみます。表の画像ではなくセルとして扱えるか確認してください。

管理番号と状態を1行ずつ照合し、リンク先も調べます。見た目が整っていても、状態が別の資料の行へ移っていては困ります。フォントや配色の調整は内容の確認後に行えます。

幅の広い実際の表では、長い見出しを短くしたり、表を分けたり、Wordで列幅を直したりします。Markdownの配置指定が、すべてのDOCX出力で同じように反映されるとは限りません。

Pandocとは何か、どんなときに使うか

Pandocは、コマンドラインから使うオープンソースの文書変換プログラムです。パソコンにインストールし、入力ファイルと出力形式を指定します。手順をスクリプトに組み込みたい場合に便利ですが、オンライン変換だけなら導入は不要です。

公式のインストール手順を済ませたら、バージョンを確認し、同じ原稿を変換します。

pandoc --version
pandoc report.md -f gfm -t docx -o report.docx

-f gfmは、この例のようなパイプ区切りの表を扱うGitHub Flavored Markdownの指定です。-t docxで出力形式、-oで保存名を選びます。report.mdがあるフォルダーで実行するか、ファイルへのパスを指定してください。「ファイルが見つからない」というエラーは、同じ命令の繰り返しではなくパスを確認して対処します。

共有する作業手順にはバージョンも記録します。ツールの更新や記法の変更後は、代表的な原稿で出力を再確認してください。

参照用DOCXでスタイルをそろえる

Pandocでは参照文書のスタイルや文書プロパティを利用できます。まずサンプルからDOCXを作成し、Wordで必要なスタイルを編集して保存した後、変換時に指定します。

pandoc report.md -f gfm -t docx -o reference.docx

reference.docxをWordで開き、必要なスタイルを変更して保存してから、次の命令を実行します。調整済みのスタイルを再利用するときは、参照ファイルを作り直して上書きしないでください。

pandoc report.md -f gfm -t docx --reference-doc=reference.docx -o report-styled.docx

参照用DOCXの本文を成果物へ付け加える機能ではなく、表紙を自動挿入する指定でもありません。対象となる設定はPandocの公式説明で確認できます。最初の出力で見出し、フォント、表幅、改ページを点検しましょう。繰り返せる命令でも、体裁の確認は必要です。

画像・数式・複雑な配置は別に点検する

現在のMDFormatsのDOCX出力には画像が埋め込まれません。プレビューに表示されても、Wordで別途追加して配置を確認する必要があります。元の画像も保存してください。

数式はMarkdownのテキストとして出力され、Wordの数式オブジェクトにはなりません。編集可能な数式が必要ならWordで作るか、その記法に対応することを確かめた別の手段を使います。PandocとMDFormatsの対応範囲は異なるため、両者の結果を同一視しないでください。

複雑な結合セル、浮動配置、ヘッダーやフッター、厳密な改ページも最終確認が必要です。Markdownの構造だけでWordのページ配置をすべて指定できるわけではありません。

渡す前に文書全体を照合する

冒頭、中ほど、末尾を確認します。この例では見出しの階層、3行3列、2つの管理番号、コードの文字、リンク、最後の段落を照合してください。セルを少し修正して保存し、受け手に必要な編集ができるかも調べます。

Wordで修正された文書を戻したい場合は、WordからMarkdownへの変換で下書きを作れます。ただし、往復変換でレイアウトが完全に残る保証はありません。戻された文書と照合し、両方の原本を残しておきます。

よくある質問

MDファイルをWordで直接開けますか？

テキストとして開くことと、Wordの見出し・表として編集することは異なります。構造を持つ文書が必要ならDOCXへ変換して確認してください。

オンライン変換にもPandocが必要ですか？

不要です。MDFormatsはブラウザで使えます。Pandocはコマンドラインや参照スタイルを利用したい場合の別の選択肢です。

DOCXはプレビューと同じ見た目になりますか？

同じになる保証はありません。アプリ、フォント、ページ設定で折り返しは変わります。特に幅の広い表や画像、数式を保存後のファイルで確認します。

変換後もMarkdownは残すべきですか？

原稿の修正に使うMarkdownと、Wordで編集するDOCXをそれぞれ残すと便利です。MarkdownからWordへの変換は、ダウンロード後の内容を確かめるところまでを作業に含めましょう。