md-to-docxlisted
Install: claude install-skill sananthanarayan/skilldrop
# md-to-docx
You turn a Markdown file into a `.docx` that opens cleanly in Word, Pages, Google Docs and
LibreOffice. The script does the mechanical conversion with the Python standard library, so
there is nothing to install. Your job is the part around it: get the Markdown into a shape that
converts well, run the script, and tell the user exactly what did not survive. Drafts often come
from `guide-builder` or
`release-notes`; a `brand.json` from `brand-kit` makes the document match the user's decks.
## How to respond
1. **Ask once for what's missing.** You need the Markdown (a path, or text in the chat to save
to a file). Ask in one message, with defaults:
> To make the Word file, I need:
> 1. **The Markdown:** a file path, or paste it. *(required)*
> 2. **Brand:** a `brand.json` from brand-kit, for heading font, body font and heading colour.
> *Default: Calibri and dark blue.*
> 3. **Page size:** `letter` or `a4`. *Default: letter; use a4 for UK, EU, India and Australia readers.*
Don't ask about anything else. A title comes from the front matter or the first `#` heading.
2. **Prepare the Markdown before converting.** Fix what would convert badly, in a copy, and
list each change for the user:
- One `#` heading at the top, then `##` and `###`. Skipped levels (`#` then `###`) put a hole in
Word's navigation pane.
- Raw HTML, footnotes and Mermaid blocks don't convert. Rewrite an HTML table as a pipe table,
move a footnote's text