rendering-docx

Convert Markdown architecture documents with diagram code blocks into Word DOCX files.

Updated Jan 22, 2026
One-click install
npx skills add https://github.com/dha201/architecture-documentation-plugin --skill rendering-docx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rendering-docx
Source: https://github.com/dha201/architecture-documentation-plugin/tree/main/plugins/architecture-documentation/skills/rendering-docx
Command: npx skills add https://github.com/dha201/architecture-documentation-plugin --skill rendering-docx

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python-docx, requests, mistune, Pillow, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill transforms architecture documentation written in Markdown, complete with diagrams, into professional Word documents suitable for formal delivery or compliance.

Core Features & Use Cases

  • Markdown to DOCX Conversion: Renders Markdown content, including text, tables, and lists, into a Word document.
  • Diagram Rendering: Automatically renders diagrams (PlantUML, Mermaid, C4, etc.) via the Kroki API and embeds them as images.
  • Use Case: You have a detailed architecture design document in Markdown with PlantUML diagrams. You need to present this to a client in a formal Word document with all diagrams embedded correctly.

Quick Start

Use the rendering-docx skill to convert the file 'architecture.md' into a Word document named 'architecture.docx'.

Frequently Asked Questions about rendering-docx

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

FAQPage Schema
How do I convert Markdown with embedded PlantUML or Mermaid diagrams into a Word document?

To convert Markdown with embedded diagrams into a Word document, this Skill parses your markdown content, renders diagrams via the Kroki API, and embeds them as PNG images into a formatted DOCX file using python-docx.

Can I render C4 and Graphviz diagrams inside markdown documentation for formal delivery?

Yes, you can render C4 and Graphviz diagrams inside markdown documentation. The Skill sends diagram code blocks to the Kroki API and embeds the returned images directly into your Word document for formal delivery.

Does markdown to DOCX conversion support corporate templates and document structure captions?

Yes, markdown to DOCX conversion supports optional corporate templates. The Skill processes your document structure, adds captions, and applies the specified template to ensure the final Word document meets compliance requirements.

What is the best way to automate architecture documentation generation from markdown to DOCX?

The best way to automate architecture documentation generation is using a script-based Skill that parses markdown, renders diagram code blocks via Kroki, and outputs a polished Word document with correctly embedded PNG images and proper structure.

Do I need the Kroki API to render markdown diagrams into a Word document?

Yes, you need the Kroki API to render markdown diagrams into a Word document. The Skill relies on Kroki to convert PlantUML, Mermaid, and D2 code blocks into PNG images that are then embedded into the final DOCX file.

Why are my markdown tables and lists not formatting correctly when converting to DOCX?

If markdown tables and lists are not formatting correctly when converting to DOCX, ensure you are using the mistune parser included in the Skill, which properly maps markdown structures into the corresponding Word document elements.