Markdown Export#

Use this skill when the user wants one Markdown source exported into docx, html, or both.

What this skill provides#

• One unified CLI for both docx and html
• Input from either a Markdown file or a raw Markdown string
• Built-in templates for both output formats
• Custom template support for both output formats
• Optional table of contents, numbered headings, metadata, and resource-path support
• HTML layout controls for optional TOC panel and plain article body rendering

Formats#

• docx Uses a Word reference.docx style template
• html Uses a Pandoc HTML template plus CSS

Built-in template names#

DOCX#

• modern-blue
• executive-serif
• warm-notebook
• minimal-gray

HTML#

• docs-slate
• magazine-amber
• product-midnight
• serif-paper

List everything with:

bash

python3 scripts/export_markdown.py --list-templates

Only list one format with:

bash

python3 scripts/export_markdown.py --format html --list-templates

Main examples#

Markdown to DOCX#

bash

python3 scripts/export_markdown.py \
  --format docx \
  --input-file /abs/path/source.md \
  --output /abs/path/output.docx \
  --builtin-template modern-blue \
  --toc \
  --number-sections

Markdown to HTML#

bash

python3 scripts/export_markdown.py \
  --format html \
  --input-file /abs/path/source.md \
  --output /abs/path/output.html \
  --builtin-template docs-slate \
  --toc \
  --embed-assets

Markdown to HTML Without TOC Background Card#

bash

python3 scripts/export_markdown.py \
  --format html \
  --input-file /abs/path/source.md \
  --output /abs/path/output.html \
  --builtin-template docs-slate \
  --embed-assets \
  --no-body-background

Raw string#

bash

python3 scripts/export_markdown.py \
  --format html \
  --markdown '# Release Notes\n\n- Export to both HTML and DOCX with one skill' \
  --output /abs/path/release.html \
  --builtin-template magazine-amber \
  --title 'Release Notes'

Template rules#

• docx --template must point to a .docx reference document
• html --template must point to a Pandoc HTML template that contains $body$
• For HTML, built-in CSS is automatically applied when using a built-in template
• For HTML, extra --css files are appended after built-in CSS
• For HTML, omitting --toc removes the TOC panel and expands the article body to full width
• For HTML, --no-body-background removes the article panel background, border, and shadow while keeping the page theme

Bundled files#

• Unified converter: scripts/export_markdown.py
• DOCX built-in templates: assets/docx/templates/*.docx
• HTML built-in templates: assets/html/templates/*.html
• HTML built-in styles: assets/html/styles/*.css

Notes#

• This skill expects pandoc to be installed and available on PATH
• If the user already has a brand template, prefer passing --template