docx-draft

Convert Word documents to structured markdown and back with python-docx.

1|1|Updated Jun 11, 2026
One-click install
npx skills add https://github.com/valtterimelkko/agent-workflow-skills --skill docx-draft
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docx-draft
Source: https://github.com/valtterimelkko/agent-workflow-skills/tree/main/skills/docx-draft
Command: npx skills add https://github.com/valtterimelkko/agent-workflow-skills --skill docx-draft

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This skill solves the issue of losing document formatting or structure when editing Word documents via LLMs, ensuring high-fidelity round-trips between Word and Markdown.

Core Features & Use Cases

  • Structured Conversion: Transforms .docx files into a specialized Markdown format that preserves paragraph and table structure.
  • Round-trip Fidelity: Allows for LLM-assisted editing while maintaining the original document's template and formatting upon conversion back to .docx.
  • Use Case: Use this when you need to collaboratively draft or revise complex forms, reports, or templates that must retain their original visual layout.

Quick Start

Use the docx-draft skill to convert the document named Quarterly_Review.docx into a structured markdown draft for editing.

Frequently Asked Questions about docx-draft

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

FAQPage Schema
How do I edit a Word document with an LLM without losing formatting?

You can edit a Word document without losing formatting by converting the .docx file into structured markdown for LLM-assisted editing. This process preserves paragraph and table structure, ensuring the original document template remains intact when converted back to .docx format.

What is the best way to use LLMs to revise complex Word templates?

The best way to revise complex Word templates using LLMs is to transform the .docx files into a specialized markdown format. This enables collaborative drafting while maintaining structural integrity and original visual layout during the round-trip conversion back to Word.

Does python-docx support converting markdown back to Word format?

Yes, python-docx can manage document elements to convert structured markdown back to Word format. It maintains structural integrity during the conversion process, ensuring the round-trip fidelity of complex forms and templates.

Can I collaboratively draft Word forms and reports in markdown?

Yes, you can collaboratively draft Word forms and reports by converting them into structured markdown. This specialized markdown format preserves paragraph and table structure for LLM-assisted editing before converting back to the original .docx layout.

Why does Word document formatting break when editing via LLMs?

Word document formatting breaks during LLM editing because standard text extraction loses structural elements. Converting .docx files into a specialized structured markdown format solves this issue by preserving paragraph and table structure for high-fidelity round-trips.