Indexed:437 news/102 AI tools/413 open-source projects/75 learning resources
HomeNewsOpen SourceModelsAI ToolsSkillsLearn
Home / Skills / Office & Docs / Markdown to Word (.docx)
Office & Docs

Markdown to Word (.docx)

awesome-copilot communityMITSkill language: English
License verifiedIncludes scriptsMedium risk
DemoReal run · claude-sonnet-5-5 · October 2026
Please turn the Markdown report at .claude/skills/md-to-docx/sample/report.md into a Word document, saved as .claude/skills/md-to-docx/sample/report.docx. Dependencies are not installed yet: install them with `npm install --prefix .claude/skills/md-to-docx/scripts` first (that exact command is allowed), then convert using relative paths. Afterwards tell me what the document contains (title page, table of contents, sections, table, image) and anything that did not convert. To check the result you may run `unzip -p .claude/skills/md-to-docx/sample/report.docx word/document.xml` (that exact command is allowed), and base your description on what is actually in the file.
Skill: md-to-docx

I converted the report and saved it as .claude/skills/md-to-docx/sample/report.docx (11 KB). The dependencies installed with only an engine warning: nanoid wants Node 22 or later and this machine has v20.19.0. The conversion ran fine anyway. The description below comes from the document XML, not just the script's success message.

What the document contains

  • Title page: "Q3 Platform Review" as the title, "Summary for Engineering" as the subtitle, then "Date: 2026-10-01 | Version: 1.2" and "Audience: Engineering, Product". It is followed by a page break.
  • Table of contents: It lists Highlights, Key numbers (indented as a sub-entry) and Plan, then a page break.
  • Sections:
    • Highlights (heading 2) has a paragraph with bold "18%", italic "0.2%", status.md in Consolas with a grey background, and "the dashboard" in blue underline.
    • Key numbers (heading 3) holds the table.
    • Plan (heading 2) has the numbered list "1. Migrate the queue" and "2. Add retries", with "exponential backoff" and "jitter" as indented bullets.
    • A Python code block follows, in Consolas on a grey background.
    • The document ends with the Chinese paragraph (中文段落：延迟下降 18%。), a horizontal rule and "Done."
  • Table: It has 3 columns (Metric, Q2, Q3) and 2 data rows, p95 latency (420 → 344) and Error rate (0.3% → 0.19%). The header row is shaded and repeats across pages, and the rows alternate in colour.
  • Image: diagrams/arch.png is embedded, centred, with the caption "Architecture".

What did not convert cleanly

  • Missing image: diagrams/nope.png was not found, so the document has the placeholder text [Image not found: diagrams/nope.png].
  • Mermaid diagram: It was not rendered. The document has the placeholder "[Diagram: See source .md file for interactive Mermaid diagram]".
  • Tiny image: The embedded architecture image is only about 0.4 × 0.2 inches (381000 × 190500 EMU). The source PNG is probably a tiny placeholder, so it will look very small in Word.
  • Dropped H1: The # Q3 Platform Review — Summary for Engineering heading does not appear in the body or the table of contents. Its text is only on the title page.
  • Link has no URL: "the dashboard" is styled as a link, but there is no hyperlink element in the file, so the https://example.com/dash URL is lost.
  • Static table of contents: It is plain text with no page numbers and no links, so it won't update in Word.
  • Fake lists: The list markers ("1.", "•") are typed characters with indentation, not real Word lists.
  • Code language dropped: The code block keeps its text but not the python language tag, and there is no syntax highlighting.
  • Chinese font: The Chinese text is set in Calibri, which has no CJK glyphs, so Word will substitute a fallback font. I didn't check how it looks.

试用方式：Skill 需要 npm 依赖，我让模型先执行文档里的 npm install，再转换我构造的示例 Markdown（含封面信息、表格、嵌套列表、代码块、PNG 图片、一个故意缺失的图片、Mermaid 代码块、中文段落）；Bash 只放行 npm install、转换命令和查看 docx 内部 XML 这三条。我另外手动解压 docx 核对，模型的描述与实际一致。示例中的 PNG 只是 40×20 像素的占位图，所以文中说它在文档里很小。

What it does

Runs a bundled Node.js script that turns a .md file into a .docx using the docx and marked npm packages, with no Pandoc or LibreOffice needed. It reads YAML front matter (title, date, version, audience) for a title page, builds a table of contents from H1 to H3, styles headings, tables with alternating row colours and code blocks, handles lists, links and rules, and embeds PNG images referenced in the Markdown (paths relative to the file, scaled to about 6 inches wide). Mermaid blocks become a placeholder line.

How it works

  1. One-time npm install in the scripts folder.
  2. node md-to-docx.mjs input.md [output.docx]; without an output name it writes next to the input name in the current directory.

Good for

Turning documentation, specs and reports written in Markdown into Word files for sharing.

Notes & risks

Medium risk: it runs a Node script and needs `npm install` (downloads `docx` and `marked`). It writes the `.docx` to the output path and replaces a file of the same name without asking, so use a new name or keep a backup. Image paths in the Markdown are resolved relative to the input file with no restriction to that folder and no check that the file is a PNG, so converting a Markdown file from an untrusted source can pull other files from disk into the document. The script makes no network requests. Test-run with correct output. Limits: links keep their text but lose the URL, the table of contents is static text with no page numbers or jumps, lists are typed characters, and only PNG is embedded (other image formats are written as PNG and may not display).