Skip to main content Skills Marketplace Descubre y explora habilidades de IA creadas por la comunidad.
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Mostrar detalles del prompt Un comando directo omite el prompt de revisión. Revisa el origen antes de ejecutarlo.
npx skills add https://github.com/fabioc-aloha/alex-cognitive-architecture --skill md-to-wordEl comando permanece en una sola línea. Desplázate horizontalmente para revisarlo antes de copiarlo.
¿Prefieres una copia local? Descarga los archivos que SkillsMP tiene disponibles ahora.
Descargar Zip Descargando... Ocupaciones relacionadas SOC
Basado en la clasificación ocupacional SOC
type skill lifecycle stable name md-to-word description Convert Markdown with Mermaid diagrams and SVG illustrations to professional Word documents tier standard applyTo **/*docx*,**/*word*,**/*md-to-word*,**/*export* muscle .github/muscles/md-to-word.cjs inheritance inheritable currency 2026-04-22T00:00:00.000Z
Markdown to Word Conversion
One command to professional Word documents — diagrams, tables, and formatting done right on first attempt.
Staleness Watch : See EXTERNAL-API-REGISTRY.md for source URLs and recheck cadence
Convert any Markdown document into polished Word (.docx) files ready for stakeholders, executives, and external audiences. Supports all standard Markdown formatting, Mermaid diagrams (auto-converted to PNG), and SVG illustrations (auto-embedded).
Why Use This?
Without This Skill With This Skill Mermaid diagrams missing or broken Auto-rendered to high-res PNG, optimally sized SVG images not displaying Auto-converted to PNG with proper dimensions Tables plain and unprofessional Microsoft-branded headers, borders, zebra striping Tables split mid-row across pages Smart pagination keeps rows intact Images overflow page boundaries 90% page coverage constraint ensures fit Bullet lists merge into paragraphs Preprocessor fixes spacing automatically Code blocks lose formatting Consolas font, gray background, proper borders Links plain text Blue underlined hyperlinks Headings inconsistent Branded colors, proper hierarchy
Document Publishing Workflow
Markdown (.md) → md-to-word.cjs → Word (.docx) → Final PDF
↓ ↓ ↓ ↓
Source Automation Manual polish Distribution
(your docs) (this skill) (page breaks, (File > Save As)
headers/footers)
Convert to Word : Run md-to-word.cjs — produces a complete, styled documentOptional polish : Add page breaks, headers/footers, custom brandingExport PDF : Word's File > Save As > PDF gives best fidelity
Supported Markdown Formatting
Headings (H1-H6)✅ Full Branded colors, proper spacing Bold/Italic/Strikethrough ✅ Full **bold**, *italic*, ~~strike~~Bullet lists ✅ Full Nested supported Numbered lists ✅ Full Auto-numbered Task lists ✅ Full - [ ] / - [x] convertedTables ✅ Full Professional styling Code blocks ✅ Full Syntax highlighting preserved Inline code ✅ Full Monospace with background Links ✅ Full Blue underlined Images (PNG/JPG)✅ Full Centered, auto-sized SVG images ✅ Auto-convert Rendered to PNG Mermaid diagrams ✅ Auto-convert Rendered to PNG Blockquotes ✅ Full Gray left border Horizontal rules ✅ Full Light gray line Footnotes ✅ Pandoc Via pandoc extension YAML frontmatter ✅ Strip --strip-frontmatter option
Mermaid Diagram Support All Mermaid diagram types are supported:
Diagram Type Detection Sizing Strategy Flowchart LR flowchart lrWidth priority (6.5") Flowchart TB flowchart tbHeight priority (3.6") Sequence sequenceDiagramWidth priority Gantt ganttWidth priority (wide) Class classDiagramAuto ER erDiagramAuto State stateDiagramAuto Pie pieSmaller width Mindmap mindmapWidth priority Timeline timelineWidth priority
Diagrams are rendered at 8x scale (2400px width) for crisp printing, then sized to fit within page bounds.
Quick Start
One-Command Conversion
node .github/muscles/md-to-word.cjs docs/spec.md
node .github/muscles/md-to-word.cjs README.md output.docx
node .github/muscles/md-to-word.cjs docs/plan.md --keep-temp
What It Does
Preprocesses Markdown — fixes bullet lists, checkbox syntax, spacingConverts Mermaid to PNG — renders diagrams with white backgroundsCalculates optimal sizing — reads actual PNG dimensions, fits 90% of pageConverts SVG to PNG — handles banner imagesGenerates Word via pandoc — clean markdown-to-docx conversionFormats tables — Microsoft blue headers, borders, alternating rowsCenters images — all diagrams centered on pageStyles headings — consistent colors and spacing
Installation
Prerequisites Tool Install (macOS) Install (Windows) Purpose Node.js 18+ brew install nodewinget install OpenJS.NodeJS.LTSScript runtime pandoc brew install pandocwinget install JohnMacFarlane.PandocMarkdown to Word mermaid-cli npm install -g @mermaid-js/mermaid-clisame Mermaid to PNG jszip (bundled with extension) same OOXML post-processing svgexport npm install -g svgexportsame SVG to PNG (optional)
Quick Install (All Dependencies) brew install pandoc
npm install -g @mermaid-js/mermaid-cli svgexport
winget install JohnMacFarlane.Pandoc
npm install -g @mermaid-js/mermaid-cli svgexport
Options Option Default Description --tocoff Generate Table of Contents --coveroff Generate cover page from H1 + date --style PRESETprofessional Style preset (see below) --page-size SIZEletter Page size: letter, a4, 6x9 --reference-doc PATH— Custom Word template (.dotx) --images-dir DIRimages Directory for generated PNG files --embed-imagesoff Embed local images as base64 --strip-frontmatteroff Remove YAML frontmatter --no-format-tablesoff Skip table styling (faster) --keep-tempoff Keep temporary files for debugging --watchoff Auto-rebuild on source change --recursiveoff Process all .md files in directory --dry-runoff Validate only, no output --debugoff Save preprocessed markdown
Style Presets Preset Body Font Heading Style Use Case professional Segoe UI 10.5pt Microsoft blue (#0078D4) Business documents, specs, reports academic Times New Roman 12pt Black, double-spaced Dissertations, papers, theses course Calibri 11pt Virginia Tech burgundy Course materials, syllabi creative Georgia 11pt Slate blue Blog posts, narratives
node md-to-word.cjs thesis.md --style academic --toc
node md-to-word.cjs quarterly-report.md --style professional --cover --toc
SVG Image Handling SVG files are automatically detected and converted to PNG for Word compatibility:
<!-- This SVG reference in your Markdown... -->
<!-- ...becomes this embedded PNG in Word -->
{width=5.8in}
Requirements : svgexport (npm install -g svgexport)
Best practices for SVG sources :
Use viewBox for scalable graphics
Embed fonts or use web-safe font stack
Keep file size under 500KB for fast conversion
Avoid external references (they won't resolve)
Image Sizing Algorithm The script automatically fits images to page bounds:
Page: 8.5" × 11" (Letter)
Margins: 1" each side
Usable area: 6.5" × 9.0"
Max image: 6.5" × 3.6" (40% height for inline fit)
Algorithm Steps
Read PNG dimensions from file header (pure Node.js, no dependencies)Calculate scale factors for width and height constraintsApply most restrictive — ensures fit in both dimensionsSpecify constraining dimension — pandoc preserves aspect ratio
Table Formatting All tables receive professional OOXML styling:
Element Style Header row Microsoft blue (#0078D4), white text, bold 10pt Even data rows Light gray (#F0F0F0) Odd data rows White (#FFFFFF) Borders Gray outer (#666666), light inner (#AAAAAA) Cell padding 2pt top/bottom, 4pt left/right Pagination cantSplit + keepWithNext (no orphan headers) Repeat headers Header row repeats on each page for long tables
Professional Features
Page Numbers Centered page numbers in the footer, gray text (9pt).
Heading Hierarchy
H1: Brand color, underline, 360/120 twip spacing
H2: Secondary color, 280/80 twip spacing
H3: Tertiary color, 240/80 twip spacing
All headings: keepNext + keepLines (no orphans)
Code Blocks
Font: Consolas 9pt
Background: Light gray (#F5F5F5)
Border: Left accent bar (#CCCCCC)
Keep together: Won't split across pages
Hyperlinks
Color: Microsoft blue (#0563C1)
Style: Single underline
Applied to both inline links and reference links
Captions Paragraphs starting with "Table N" or "Figure N":
Centered, italic, 9pt gray
keepNext binding to following content
Troubleshooting Issue Cause Fix "mmdc not found" mermaid-cli not installed npm install -g @mermaid-js/mermaid-cli"pandoc not found" pandoc not in PATH winget install JohnMacFarlane.Pandoc (restart terminal)"svgexport not found" svgexport not installed npm install -g svgexportTables not styled jszip not available Set NODE_PATH to extension node_modules Diagrams too small Outdated script Update to v5.3.0+ Images overflow Complex diagram Use --debug and check PNG dimensions SVG not converting Missing svgexport Install or use PNG source Document corrupt Incomplete write Check disk space, re-run
Debug Mode node md-to-word.cjs doc.md --debug --keep-temp
macOS Fallback (No Pandoc) macOS ships textutil which can convert HTML to DOCX natively:
npx marked document.md -o document.html
textutil -convert docx document.html -output document.docx
Feature Pandoc (primary) textutil (fallback) Table styling Full (via jszip post-processing) Basic Mermaid diagrams Supported (pre-rendered PNG) Must be pre-rendered Heading styles Mapped to Word styles Basic HTML mapping Cross-references Supported Not supported Install brew install pandocBuilt-in (macOS only)
Limitations : textutil needs HTML input (not raw Markdown), produces simpler formatting, and doesn't support the table styling or image sizing that md-to-word.cjs provides. Use only when Pandoc is unavailable and a quick conversion is needed.
Batch Processing
Convert a Folder # Windows PowerShell
Get-ChildItem docs/*.md | ForEach-Object {
node .github/muscles/md-to-word.cjs $_.FullName --style professional
}
for f in docs/*.md; do
node .github/muscles/md-to-word.cjs "$f " --style professional
done
Recursive Directory
node .github/muscles/md-to-word.cjs docs --recursive --style professional
Watch Mode
node .github/muscles/md-to-word.cjs spec.md --watch
Integration Examples
GitHub Actions CI/CD
- name: Generate Word Documents
run: |
npm install -g @mermaid-js/mermaid-cli svgexport
node .github/muscles/md-to-word.cjs docs/spec.md --toc --cover
- name: Upload artifacts
uses: actions/upload-artifact@v4
with:
name: word-documents
path: docs/*.docx
npm Script {
"scripts" : {
"docs:word" : "node .github/muscles/md-to-word.cjs docs/README.md --style professional --toc"
}
}
For Heir Projects
Copy .github/muscles/md-to-word.cjs to your project
Copy shared modules from .github/muscles/shared/ (markdown-preprocessor, mermaid-pipeline)
Install prerequisites: npm install -g @mermaid-js/mermaid-cli svgexport
Run: node .github/muscles/md-to-word.cjs your-doc.md
Version History Version Changes 5.3.0 Style presets (professional, academic, course, creative), --cover, --toc 5.0.0 SVG auto-conversion via svgexport, watch mode, recursive processing 4.0.0 OOXML post-processing: page numbers, hyperlinks, code block styling 3.0.0 Markdown preprocessing, heading colors, caption formatting 2.1.0 Table pagination (cantSplit, keepWithNext) prevents orphan headers 2.0.0 90% H+V coverage, actual PNG dimension reading 1.0.0 Initial: pandoc + mermaid + table formatting
Conversion Acceptance Decision Table Condition Verdict Action All headings use correct Word styles (Heading 1-6) Accept Verify TOC generates from styles Headings are bold plain text instead of styled Reject Check pandoc heading-style mapping Tables render with borders and header row formatting Accept Spot-check alignment Tables overflow page width or lose column alignment Reject Adjust column widths or split wide tables Images embedded at correct resolution Accept Verify no placeholder boxes Images missing or show [image] placeholder Reject Check image paths resolve; pandoc --resource-path Mermaid diagrams converted to PNG and embedded Accept Verify labels readable at print size Mermaid diagrams missing entirely Reject Pre-render with mermaid-cli before pandoc Code blocks use monospace font with syntax coloring Accept Verify long lines don't overflow Code blocks use body font or lose indentation Warning Check pandoc --highlight-style setting Page breaks at expected section boundaries Accept Required for multi-section documents Headers/footers match brand template Accept Verify reference.docx applied correctly File opens without macro warnings Accept Required — no macros in output File size >10MB for text-only document Warning Check for uncompressed embedded images
Related Skills Skill Relationship markdown-mermaid Mermaid syntax and ATACCU compliance svg-graphics Vector graphics creation brand-asset-management Visual identity for headers/footers pptx-generation Similar workflow for PowerPoint output md-to-html HTML output with same preprocessing md-scaffold Templates for clean Markdown structure book-publishing Pandoc PDF for print publishing
