md-to-docx

Convert Markdown files to DOCX with Chinese font support.

54|19|Updated Jan 13, 2026
One-click install
npx skills add https://github.com/Xueheng-Li/sysu-awesome-cc --skill md-to-docx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: md-to-docx
Source: https://github.com/Xueheng-Li/sysu-awesome-cc/tree/main/skills/md-to-docx
Command: npx skills add https://github.com/Xueheng-Li/sysu-awesome-cc --skill md-to-docx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts Markdown documents into professionally formatted Word documents (.docx) while preserving layout, fonts, and structure, especially for Chinese text, reducing manual formatting time.

Core Features & Use Cases

  • Precise Markdown to DOCX conversion: keeps headings, lists, tables, code blocks, images, and links intact.
  • Chinese font support by default: uses FangSong for Chinese text to ensure readability in formal documents.
  • Template flexibility: supports a reference Word template for organizational styling and a default Chinese template.
  • Citation handling and typography: applies consistent typography, line spacing (1.5x), 24pt first-line indent, and black text.
  • Use Case: convert team docs or research notes written in Markdown into ready-to-share Word documents.

Quick Start

Place a Markdown file and run the provided Python script to generate a DOCX file.

Frequently Asked Questions about md-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 proper Chinese font support?

To convert Markdown to docx with Chinese font support, you can use a tool that applies a default template utilizing FangSong for readability. It requires pandoc and python-docx to execute the conversion script and generate the file.

Can I use a custom Word template when converting Markdown to docx?

Yes, you can use a custom Word template when converting Markdown to docx by providing a reference document. If no custom reference document is supplied, the conversion defaults to a built-in Chinese template.

How to preserve formatting like tables and code blocks when converting Markdown to docx?

Converting Markdown to docx while preserving formatting requires a conversion tool that keeps headings, lists, tables, code blocks, images, and links intact. The process applies consistent typography like 1.5x line spacing and 24pt first-line indent.

Do I need pandoc and python-docx to convert Markdown files into shareable Word documents?

Yes, you need pandoc and python-docx installed to convert Markdown files into shareable Word documents. These dependencies handle the core file parsing and docx generation, ensuring structural elements and typography are correctly applied.

What is the best way to format Markdown notes into a formal Word document for sharing?

The best way to format Markdown notes into a formal Word document is using an automated conversion script that applies a predefined template. This ensures consistent typography, 1.5x line spacing, and black text, reducing manual formatting time.

Why does my Markdown to docx conversion lose Chinese text formatting?

Markdown to docx conversion may lose Chinese text formatting if no specific template is applied. Using a default Chinese template with FangSong font and 24pt first-line indent ensures proper readability and layout for formal documents.