How do I install the Pandoc DOCX skill?

Run npx skillmds@latest add mengbo/pandoc-docx in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Pandoc DOCX safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Pandoc DOCX?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Pandoc DOCX free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Pandoc DOCX?

mengbo (@mengbo) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Pandoc DOCX by mengbo — Agent Skill

Name: Pandoc DOCX
Author: mengbo

Pandoc DOCX

Universal document conversion using Pandoc with focus on DOCX format. Use when converting documents to or from DOCX format, including Markdown, HTML, PDF, and other formats. Supports: (1) Converting other formats to DOCX (Markdown, HTML, reStructuredText, etc.), (2) Converting DOCX to other formats, (3) Custom DOCX templates and styling, (4) Batch document processing

mengbo b981d07 4 files · 522.1 KB Updated Sep 17, 2026

File contents

Pandoc Docx

Prerequisites

Ensure Pandoc is installed:

pandoc --version
# If not installed: brew install pandoc (macOS) or apt-get install pandoc (Linux)

Directory Setup

Create working directories in your project root:

mkdir -p import export

import/ - Source files to convert
export/ - Converted output files

Convert to DOCX

Basic conversion:

pandoc import/input.md -o export/output.docx

Common options:

--reference-doc=template.docx - Apply custom styling
--toc - Generate table of contents
--toc-depth=2 - Set TOC depth
--metadata="title=My Document" - Set document metadata

Use skill's Chinese template:

# Path depends on where skill is installed:
# - Project local: .agents/skills/pandoc-docx/ (or your skill installation path)
# - Global: ~/.config/skills/pandoc-docx/ (varies by OS and tool)

pandoc import/input.md -o export/output.docx \
  --reference-doc=<skill-path>/assets/templates.docx

Convert from DOCX

pandoc import/document.docx -o export/document.md --extract-media=export/images/

Custom Templates

Generate default template: pandoc --print-default-data-file reference.docx > reference.docx
Edit styles in Word
Apply: pandoc import/input.md -o export/output.docx --reference-doc=reference.docx

Batch Processing

SKILL_PATH="<skill-path>"  # Adjust to your skill installation path

for file in import/*.md; do
  pandoc "$file" -o "export/$(basename "${file%.md}").docx" \
    --reference-doc=$SKILL_PATH/assets/templates.docx
done

Resources

assets/templates.docx - Chinese DOCX template with title numbering and code highlighting
scripts/convert.sh - Helper script for conversions (see usage below)
references/pandoc-options.md - Complete option reference and advanced patterns

Using convert.sh

# Run from project root. Adjust <skill-path> to where skill is installed:
<skill-path>/scripts/convert.sh report.md report.docx

# With options
<skill-path>/scripts/convert.sh report.md report.docx --toc

# Absolute paths work as usual
<skill-path>/scripts/convert.sh /path/to/input.md /path/to/output.docx

---name: pandoc-docxdescription: Universal document conversion using Pandoc with focus on DOCX format. Use when converting documents to or from DOCX format, including Markdown, HTML, PDF, and other formats. Supports: (1) Converting other formats to DOCX (Markdown, HTML, reStructuredText, etc.), (2) Converting DOCX to other formats, (3) Custom DOCX templates and styling, (4) Batch document processing---# Pandoc Docx## PrerequisitesEnsure Pandoc is installed:```bashpandoc --version# If not installed: brew install pandoc (macOS) or apt-get install pandoc (Linux)```## Directory SetupCreate working directories in your project root:```bashmkdir -p import export```- `import/` - Source files to convert- `export/` - Converted output files## Convert to DOCXBasic conversion:```bashpandoc import/input.md -o export/output.docx```**Common options:**- `--reference-doc=template.docx` - Apply custom styling- `--toc` - Generate table of contents- `--toc-depth=2` - Set TOC depth- `--metadata="title=My Document"` - Set document metadata**Use skill's Chinese template:**```bash# Path depends on where skill is installed:# - Project local: .agents/skills/pandoc-docx/ (or your skill installation path)# - Global: ~/.config/skills/pandoc-docx/ (varies by OS and tool)pandoc import/input.md -o export/output.docx \ --reference-doc=<skill-path>/assets/templates.docx```## Convert from DOCX```bashpandoc import/document.docx -o export/document.md --extract-media=export/images/```## Custom Templates1. Generate default template: `pandoc --print-default-data-file reference.docx > reference.docx`2. Edit styles in Word3. Apply: `pandoc import/input.md -o export/output.docx --reference-doc=reference.docx`## Batch Processing```bashSKILL_PATH="<skill-path>" # Adjust to your skill installation pathfor file in import/*.md; do pandoc "$file" -o "export/$(basename "${file%.md}").docx" \ --reference-doc=$SKILL_PATH/assets/templates.docxdone```## Resources- **assets/templates.docx** - Chinese DOCX template with title numbering and code highlighting- **scripts/convert.sh** - Helper script for conversions (see usage below)- **references/pandoc-options.md** - Complete option reference and advanced patterns### Using convert.sh```bash# Run from project root. Adjust <skill-path> to where skill is installed:<skill-path>/scripts/convert.sh report.md report.docx# With options<skill-path>/scripts/convert.sh report.md report.docx --toc# Absolute paths work as usual<skill-path>/scripts/convert.sh /path/to/input.md /path/to/output.docx```

Frequently asked questions