Markdown to DOCX Skill | Template-Driven Word Export Download
An open-source Markdown-to-DOCX Skill built around Pandoc, Obsidian image embeds, Mermaid rendering, caption repair, and DOCX/DOTX template styling for polished Word output.
☕ Pay What You Want
ZIP · 24KB
Overview
This is an open-source Skill for exporting Markdown into higher-quality .docx documents, designed for AI Agent workflows, editorial pipelines, and structured content delivery.
Its real value is not just that it can convert Markdown into Word. It lets you drive the final output with an existing Word template system. You can reuse any .docx or .dotx reference template and let that style system shape the final document.
That makes it much more practical for formal deliverables such as books, research notes, course handouts, internal documentation, or report workflows where Word is still the final handoff format.
Core Capabilities
Template-driven Word output
- Reuse any
.docxor.dotxtemplate to control final styling - Map headings, body text, captions, tables, and code blocks into template styles
- Better fit for publishing, enterprise, and institutional documentation workflows
Better support for Obsidian and Markdown-based writing
- Handles Obsidian image embeds like
![[image.png]] - Expands resource paths so linked assets are less likely to break
- Can convert one Markdown file or a directory of top-level Markdown files into separate DOCX outputs
More than conversion: cleanup and quality repair
- Repairs common missing figure and table caption issues
- Handles caption/image line-merging problems, heading numbering conflicts, list indentation, code style, and table borders
- Includes post-export validation so you can catch formatting issues before delivery
Mermaid support
- Can render Mermaid code blocks to PNG when Node.js and
npxare available - Useful for technical writing, process diagrams, architecture notes, and flow-heavy documentation
Package Contents
This ZIP mainly includes:
SKILL.md: full workflow documentationscripts/convert_markdown_to_docx.sh: base Markdown-to-DOCX conversion scriptscripts/render_markdown_with_dotx.sh: template-based rendering pipelinescripts/template_style_filter.lua: style mapping filterscripts/postprocess_template_docx.py: template-aware DOCX post-processingscripts/validate_captions.py: caption and output validation toolscripts/render_mermaid_blocks_for_docx.py: Mermaid rendering helperreferences/editorial-template-rules.md: editorial formatting guidance
Who This Is For
- Writers and content teams that draft in Markdown but deliver in Word
- Obsidian users turning long-form notes into formal
.docxoutput - Developers building AI-assisted DOCX export workflows
- Teams that already have publisher, company, or house Word templates
- Anyone who wants Markdown as the source format and DOCX as the final deliverable
Why It’s Worth Downloading
The biggest problem with many Markdown-to-Word tools is not whether they can export a file. It is that the result still needs manual cleanup in Word.
This Skill is valuable because it closes that gap:
- content can still be authored in Markdown
- AI and automation workflows can continue to operate on plain text
- the final deliverable remains a polished
.docx - layout details such as heading hierarchy, list geometry, table styling, and figure captions can be controlled by both template rules and post-processing
If you already have a Word template and want future Markdown content to inherit that style consistently, this resource is a strong starting point.
TuneFab Streaming Music Converter
Download and convert Spotify, Apple Music, YouTube Music, Amazon Music, Deezer, Pandora, SoundCloud, and Audible to MP3, WAV, or FLAC.
- Supports major streaming music platforms and Audible.
- Keeps original quality while exporting MP3, WAV, or FLAC.
- Useful when you want offline listening and a single desktop workflow.
Affiliate links. Opens TuneFab in a new tab.
☕ Like this resource?