skills.rest
fabioc-aloha
fabioc-alohaCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

md-to-word

Convert Markdown documents with Mermaid diagrams into formatted Word files.

1|1|Updated Nov 20, 2025
Search Tags:#documentation#markdown#pandoc#conversion#word#diagrams
One-click install
npx skills add https://github.com/fabioc-aloha/AIRS_Data_Analysis --skill md-to-word-fabioc-aloha
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: md-to-word
Source: https://github.com/fabioc-aloha/AIRS_Data_Analysis/tree/main/.github/skills/md-to-word
Command: npx skills add https://github.com/fabioc-aloha/AIRS_Data_Analysis --skill md-to-word-fabioc-aloha

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pandoc, mermaid-cli, python-docx, svgexport, and includes scripts (resource) components.

What problem does it solve?

This Skill automates the conversion of Markdown documents, including complex Mermaid diagrams, into professional Word documents, streamlining the publishing workflow.

Core Features & Use Cases

  • Mermaid Diagram Conversion: Renders Mermaid diagrams into PNGs with optimal sizing for Word.
  • Professional Table Formatting: Applies styling like blue headers, borders, and alternating rows to tables.
  • SVG to PNG Conversion: Handles banner images by converting them to a compatible format.
  • Use Case: Convert your technical specification document written in Markdown, complete with flowcharts and sequence diagrams, into a polished .docx file suitable for executive review.

Quick Start

Convert the markdown file named 'spec.md' to a word document.

Frequently Asked Questions about md-to-word

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

FAQPage Schema
How do I convert a Markdown document with Mermaid diagrams into a Word file?▼

To convert Markdown to Word, this Skill renders Mermaid diagrams to PNGs and uses pandoc to generate a formatted .docx file with professional table styling.

Does pandoc support converting complex Mermaid flowcharts and sequence diagrams to Word?▼

Yes, this Skill handles Mermaid diagram conversion by rendering Gantt, Flowchart, Sequence, Class, ER, and Pie diagrams into PNGs with optimal sizing for Word, overcoming pandoc's native limitations with Mermaid.

What is the best way to convert SVG banners and Markdown tables into a formatted Word document?▼

The best way to convert SVG banners and Markdown tables is using this Skill, which converts SVGs to PNGs for compatibility and applies professional table formatting with blue headers, borders, and alternating rows via python-docx.

Do I need mermaid-cli and python-docx installed to automate Markdown to Word conversion?▼

Yes, you need mermaid-cli to render Mermaid diagrams and python-docx to apply professional table styling, alongside pandoc and svgexport, to fully automate the Markdown to Word conversion workflow.

Why do my Markdown tables lose their formatting when I convert documents to .docx?▼

Markdown tables lose formatting during standard .docx conversion because default tools lack styling logic. This Skill applies professional table formatting with blue headers, borders, and alternating rows using python-docx to prevent this.

Related Skills

Explore More Content & Communication Skills→
desmondc9desmondc9

markdown-to-docx

Convert Markdown files to DOCX with Mermaid diagrams and a table of contents.

Community
Advanced
malue-aimalue-ai
36

word-processor

Generate and edit Microsoft Word .docx documents using python-docx.

Official
Intermediate
odeciojuniorodeciojunior

mermaid-designer

Convert textual specifications into valid Mermaid diagram source code.

Community
Intermediate
YH-05YH-05
1

md2docx

Convert Markdown files to Word documents with pandoc and custom templates.

Community
Intermediate