markdown-to-docx

Convert Markdown documents into Word .docx files with embedded images and captions.

7|1|Updated May 9, 2026
One-click install
npx skills add https://github.com/black-yt/skills --skill markdown-to-docx-black-yt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-to-docx
Source: https://github.com/black-yt/skills/tree/main/markdown-to-docx
Command: npx skills add https://github.com/black-yt/skills --skill markdown-to-docx-black-yt

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bs4, docx, markdown, lxml, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill converts Markdown documents into editable Microsoft Word .docx deliverables, removing the need for manual copy-paste formatting and preserving a readable, professional structure for business and public-facing documents.

Core Features & Use Cases

  • Deterministic Markdown to DOCX conversion: Uses a repeatable Python workflow to turn headings, lists, quotes, links, code blocks, and images into Word output.
  • Local image embedding and captions: Supports local relative image paths, centered image placement, width control, and caption generation from alt text.
  • Typography and quality checks: Lets users set Chinese or English fonts, estimate visible word counts, and verify the generated document with a companion counting script.
  • Use Case: A team can turn a release note or project report written in Markdown into a shareable Word document with embedded screenshots and readable formatting.

Quick Start

Ask the skill to convert your Markdown file into a Word .docx document with embedded local images, readable headings, and the preferred Chinese or English font settings.

Frequently Asked Questions about markdown-to-docx

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert Markdown to Word docx with embedded local images?

To convert Markdown to Word docx with embedded local images, use a deterministic Python workflow that maps headings, lists, and relative image paths into centered, captioned figures within a readable .docx file.

Can I generate image captions from alt text when converting Markdown to docx?

Yes, you can generate image captions from alt text during Markdown to docx conversion. The process automatically extracts alt text to create readable captions and centers the local images with proper width control.

How do I set Chinese or English fonts when converting a Markdown document to Word?

You can set Chinese or English fonts when converting a Markdown document to Word by specifying your preferred typography settings before the conversion process, ensuring the generated .docx output uses the correct readable fonts.

Does python-docx support visible word count estimation for converted Markdown files?

Yes, python-docx supports visible word count estimation for converted Markdown files. A companion counting script verifies the generated document to ensure the visible word count meets your requirements.

What is the best way to convert Markdown release notes into a formatted Word document?

The best way to convert Markdown release notes into a formatted Word document is using a repeatable conversion workflow that preserves headings, quotes, links, and code blocks while embedding screenshots with readable typography.

Are there limitations when converting Markdown to docx using python-docx?

Limitations when converting Markdown to docx using python-docx include relying on dependencies like bs4 and lxml for parsing, requiring local relative image paths for embedding, and needing predefined font selections for consistent typography.