mcpField
M
md-to-docx

md-to-docx

github.com/githubドキュメント40.5k357 回インストール1 日前に更新
リポジトリ

md-to-docx について

Markdown ファイルを、PNG 画像を含む書式付き Word 文書に変換するスキルです。JavaScript パッケージを使い、ネイティブバイナリなしで表紙や目次、整形済みの本文を生成します。

主な機能

  1. 01Markdown から DOCX への変換
  2. 02YAML フロントマターによる表紙生成
  3. 03H1〜H3 から目次を作成
  4. 04PNG 画像の埋め込み
  5. 05表とコードブロックのスタイル設定
  6. 06各種 Markdown 要素に対応

活用シーン

  1. 01Markdown のレポートを Word 化
  2. 02表紙と目次付きの文書を作成
  3. 03PNG 図を含む Markdown を変換

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/github/awesome-copilot --skill md-to-docx

インストール後、Claude Code で/md-to-docxを入力して読み込まれたか確認します。

同梱ファイルscripts/md-to-docx.mjsscripts/package.json

詳細

Markdown を Word（.docx）に変換するスキル

Markdown（.md）ファイルを、PNG 画像を埋め込んだ、プロフェッショナルな書式の Word（.docx）ドキュメントに変換します。docx と marked の npm パッケージを使った 純粋な JavaScript で動作し、Pandoc、LibreOffice、ネイティブバイナリは必要ありません。

変換方法

# Install dependencies (one-time, from the scripts folder)
cd skills/md-to-docx/scripts && npm install

# Convert (run from workspace root)
node skills/md-to-docx/scripts/md-to-docx.mjs <input.md> [output.docx]

output.docx を省略すると、現在のディレクトリにある <input-basename>.docx が出力先として使用されます。

スキルフォルダーの内容

ファイル用途
SKILL.mdこの手順ファイル
scripts/md-to-docx.mjsNode.js の Markdown から Word へのコンバーター
scripts/package.json依存関係（docx、marked）

前提条件

要件バージョン備考
Node.js18+必須のランタイム
docx9+純粋な JS による Word ドキュメント生成ツール
marked15+Markdown パーサー

ネイティブバイナリは不要です。システムレベルのインストールも不要です。Windows、macOS、Linux で動作します。

機能

このコンバーターは、次の処理を行います。

  • YAML フロントマターを抽出 — タイトルページに title、date、version、audience を使用します
  • タイトルページを生成 — プロジェクト名、サブタイトル、日付、バージョン、対象読者を記載します
  • 目次を生成 — H1～H3 の見出しから作成します
  • PNG 画像を埋め込み — ![alt](path) の参照を入力 .md ファイルからの相対パスで解決し、PNG を読み込んで Word ドキュメントにインラインで埋め込みます
  • 書式付きの出力 — Calibri フォント、色付きの見出し（#1F3864）、交互に行の色を変えた書式付きテーブル、Consolas のコードブロックを使用します
  • すべての Markdown 要素に対応 — 見出し、段落、テーブル、コードブロック、リスト、画像、リンク、水平線を処理します

画像の埋め込み

このコンバーターは、Markdown で参照されている PNG 画像を自動的に埋め込みます。

![High-Level Architecture](diagrams/high-level-architecture.drawio.png)

画像のパスは 入力 Markdown ファイルからの相対パス として解決されます。PNG を読み込み、PNG ヘッダーから寸法を取得した後、縦横比を維持しながら幅 6 インチ以内に収まるよう画像を拡大縮小します。

画像ファイルが見つからない場合は、プレースホルダー [Image not found: <path>] が挿入されます。

フロントマターの形式

---
title: Project Name — Project Summary
date: 2025-01-15
version: 1.0
audience: Engineering Team, Architects, Stakeholders
---

タイトルページ用に、タイトルは — または – でメインタイトルとサブタイトルに分割されます。

コメント

Markdown 対応