md-to-docx-template

テンプレートを使ったMarkdownからDOCXへの変換

Markdownを、プロフェッショナルなスタイルのWord文書に変換します。単なるエクスポートではなく、フォント、色、表のスタイルを自動で適用した、美しくブランドイメージに合った文書を作成できます。

使用する場面

• MarkdownをWord／DOCXに変換したい場合
• Markdownソースからブランドイメージに合った文書を作成したい場合
• Markdownをスタイル付きでエクスポートする方法を尋ねられた場合
• 「md to docx」「markdown to word」などに言及された場合

前提条件

• pandoc がインストールされていること（macOSでは brew install pandoc）
• Python 3.8以降と、次のパッケージ：python-docx、lxml、click、pyyaml

インストール

このスキルのスクリプトを、任意の場所にクローンします。

git clone https://github.com/jonnyschneider/skills
cd skills/skills/md-to-docx-template
pip install python-docx lxml click pyyaml

クイック変換

./md-to-docx.py input.md -o output.docx

カスタムテンプレートを使用する

オプションA：指定したフォント／色でテンプレートを生成する

./create-reference-template.py template.docx \
  --font-body "DM Sans" \
  --font-heading "DM Sans" \
  --accent-color "0D494D" \
  --heading-color "0D494D"

./md-to-docx.py input.md -o output.docx --template template.docx

オプションB：既存のブランド文書からスタイルを抽出する

# Full pipeline for best results:
./extract-styles.py source-branded.docx template.docx
./md-to-docx.py input.md -o output.docx --template template.docx --no-fix-indent
./apply-template-styles.py template.docx output.docx
./fix-table-headers.py output.docx

複数ファイルの文書

manifest.yaml を作成します。

template: template.docx
output: final-document.docx
sections:
  - 01-intro.md
  - 02-content.md
  - 03-conclusion.md

次に、以下を実行します。

./md-to-docx.py manifest.yaml --open

主なオプション

オプション	説明
-o, --output	出力DOCXのパス
--template	カスタム参照テンプレート
--toc	目次を生成
--open	ビルド後に開く
--no-fix-indent	リストのインデント修正をスキップ（抽出パイプラインで使用）

テンプレートのオプション

オプション	説明
--font-body	本文のフォント（デフォルト：Calibri）
--font-heading	見出しのフォント（デフォルト：Calibri）
--font-mono	コードのフォント（デフォルト：Consolas）
--accent-color	表ヘッダーの色（16進数、デフォルト：4472C4）
--heading-color	見出しテキストの色（16進数、デフォルト：000000）

制限事項

• カスタムフォントは対象のマシンにインストールされている必要があります
• 複雑な表は正しくレンダリングされない場合があります
• SVG画像には rsvg-convert が必要です
• pandocの一部の仕様に対応するため、後処理スクリプトが必要です