How to convert Markdown to a branded Word document

Writing in Markdown is fast, portable, and version-control friendly. But clients, managers, and procurement teams want Word documents — with your logo, your fonts, and your company colours. Bridging that gap manually wastes hours every week.

Why Markdown → DOCX matters

Markdown is the default format for technical writers, developers, and anyone who works in a code editor or version-control system. The problem isn't writing in Markdown; it's the last mile: turning a .md file into a polished .docx that looks like it came from your design team.

The naive solution — copy-paste into Word, re-apply styles, add the logo — takes 20–40 minutes per document. If you're producing ten documents a week that's a part-time job.

The template-based approach

The right answer is a reference document (also called a DOCX template): a Word file where every paragraph style (Heading 1, Normal, Code Block, etc.) is pre-configured with your brand's fonts, colours, and spacing. When Pandoc converts your Markdown, it maps each Markdown element to the corresponding style in your template.

You maintain the template once. Every conversion inherits it automatically.

Step-by-step with Wagoe Blueprint

1. Upload your template — Go to Templates in the app and upload your branded .docx file. Wagoe stores it securely and associates it with your organisation.
2. Convert your Markdown — Drag your .md file onto the converter, choose Word (.docx) as the output format, and select your template.
3. Download — A fully branded DOCX is ready in seconds.

Using the REST API

For automated pipelines, use the API:

curl -X POST https://your-org.wagoe.com/api/v1/convert \
  -H "X-API-Key: wbk_live_..." \
  -F "md-file=@report.md" \
  -F "template-id=<your-template-uuid>" \
  -F "output-format=docx" \
  -o report.docx

You can call this from a GitHub Action, a CI/CD pipeline, or any server-side script.

What about PDF?

Wagoe also converts to PDF using a Chrome headless renderer. PDF output respects your DOCX template's styles and can include a custom header with your logo on every page. See Markdown to PDF for the full guide.

Summary

Stop spending time on formatting. Upload your template once, and every Markdown file you write becomes a polished Word document automatically.