Markdown を Word に変換

Markdown はソースコード管理や集中した執筆に向いていますが、レビュー、承認、共同作業の多くは今でも Word 互換の文書上で行われています。同僚がコメント、変更履歴、ヘッダー、社内テンプレート、使い慣れた書式設定を必要とすることもあります。この変換ツールは Markdown の構造を DOCX のコンポーネントに変換するので、結果は修正できないページのスナップショットではなく、そのままオフィスのワークフローに乗せられます。

変換は Markdown のソーステキストから始まります。見出しは Word の見出し段落に、通常のテキストは段落とテキストランに、リストは順序を保ったまま、表は編集可能なセルに、コードブロックは等幅書式になります。DOCX の構築はブラウザ内で行われ、パッケージ化されたファイルが現在の端末にダウンロードされます。

まず Markdown を貼り付けるか読み込み、リアルタイムプレビューで構造上の問題を見つけます。エクスポート前に、見出し、リストのインデント、表の区切り、コードフェンス、数式、Mermaid の定義を直しておきましょう。「Word にエクスポート」をクリックすると、文書ビルダーが Markdown を解析し、対応するノードを変換し、必要に応じて画像や図をレンダリングし、DOCX をパッケージ化してダウンロードを開始します。

Microsoft Word、Google ドキュメント、LibreOffice、その他の互換ソフトで markdown-viewer-document.docx を開いてください。ファイルは編集可能なままなので、組織のテンプレート、ページ番号、ヘッダー、表紙、コメント、変更履歴をそのまま適用できます。オフィスソフトごとに組版エンジンやフォント環境が異なるため、正確な余白や折り返しには違いが出る場合があります。

エクスポーターは、見出し、段落、太字、斜体、リンク、番号付き・番号なしリスト、引用、区切り線、インラインコード、フェンスコードブロック、表、画像を処理します。コードブロックはスタイル付きのコンテナに入り、表は画像ではなく本物の Word の表になるため、ダウンロード後もセルの文字を修正できます。

対応している LaTeX は Office Math の構造に変換されるので、数式はスクリーンショットではなくネイティブの数式に近い形になります。Mermaid のコードブロックは、まず画像としてレンダリングされてから文書に挿入されます。複雑な TeX パッケージや、ラベルが非常に小さい密度の高い図は、最終的な DOCX で確認が必要です。対応できない構造は、通常の本文を黙って書き換えるのではなく、明確に失敗するようになっています。

レビュアーが文章を直したり、コメントを付けたり、会社のテンプレートを適用したり、内容を既存のオフィス文書に統合したりする場合は、Word を選んでください。提案書、社内レポート、授業資料、仕様書、テクニカルライターが非技術系の同僚に渡す内容に適しています。今後も Web 公開やバージョン管理が必要になる場合は、元の Markdown をクリーンなソースファイルとして残しておくことをおすすめします。

読んで印刷するだけで、レイアウトを安定させたいなら PDF、開発者が Web ページを公開したり CSS をカスタマイズしたりするなら HTML を選んでください。Word はその中間にあり、文書構造を保ちながらオフィスソフトでの修正を続けられます。

DOCX はオープンなオフィス文書コンテナですが、Word、Google ドキュメント、LibreOffice では、フォントの代替、段落の間隔、表の幅、数式や画像の拡縮の扱いが完全には一致しません。変換ツールは構造化されたコンテンツを生成しますが、受け取る側のコンピューターにどのフォントが入っているか、企業テンプレートがどのスタイルを上書きするかを事前に知ることはできません。正式に納品する前に、対象のオフィスソフトでファイルを開き、見出し階層、リスト番号、表のページ跨ぎ、コードの折り返し、画像サイズ、数式のベースラインを確認してから、組織のテンプレートを適用してください。

文書が開けない場合は、ダウンロードしたファイルの拡張子が .docx であること、ダウンロードがブラウザに中断されていないことを確認してください。図が欠けている場合は、プレビューに戻って Mermaid のソースにエラーがないことを確かめ、再度エクスポートします。情報量の多い図は Word 内で画像として挿入されるため、サイズの調整はできますが、通常のテキストのように項目ごとに編集することはできません。複雑な LaTeX が現在の変換ツールの対応範囲を超える場合は、数式を簡略化する、複数の式に分ける、エクスポート後に Word の数式エディターで補うなどの方法があります。元の Markdown を残しておけば、どんな互換性調整を行ったあとでも、バージョン管理できるソースを持ち続けられます。

複数人で共同作業する場合は、Markdown のソースを誰が管理し、エクスポートした Word のコピーを誰が管理するかをあらかじめ決めておくと、双方が同時に修正して統合できなくなる事態を避けられます。DOCX に追加されたコメント、変更履歴、ヘッダー、テンプレートのスタイルは Markdown に自動で書き戻されません。レビューの結果を長期的なバージョンに反映する必要がある場合は、コンテンツの責任者が確定した文章をソースファイルに戻して再エクスポートしてください。ブランドフォント、表紙、目次、ページ番号を維持する必要がある文書では、まず構造化された DOCX を生成し、その後 Word で組織のテンプレートを適用するとよいでしょう。目次は通常、見出しスタイルに依存するため、適用後はフィールドを更新してページ番号を確認し、プレビュー上の Web の見た目を最終的なオフィス組版とみなさないようにしてください。