Agent-Skills.md

Agent Skills: markdown-to-docx

[Utilities] Convert markdown files to Microsoft Word (.docx) with custom styling. Use when generating Word documents from markdown, creating editable documentation, or exporting reports for Microsoft Office.

UncategorizedID: duc01226/easyplatform/markdown-to-docx

Repository

duc01226/easyplatform
duc01226License: MIT
31

Install this agent skill to your local

pnpm dlx add-skill https://github.com/duc01226/EasyPlatform/tree/HEAD/.claude/skills/markdown-to-docx

Skill Files

Browse the full folder contents for markdown-to-docx.

Download Skill

Loading file tree…

.claude/skills/markdown-to-docx/SKILL.md

Skill Metadata

Name
markdown-to-docx
Description
'[Document Processing] Convert markdown files to Microsoft Word (.docx) format with GFM support and math rendering'

[IMPORTANT] Use TaskCreate to break ALL work into small tasks BEFORE starting — including tasks for each file read. This prevents context loss from long files. For simple tasks, AI MUST ATTENTION ask user whether to skip.

Quick Summary

Goal: Convert Markdown files to Microsoft Word (.docx) format with GFM support and proper formatting.

Workflow:

  1. Install -- Ensure pandoc is available (required dependency)
  2. Convert -- Run pandoc with docx output, apply reference template if provided
  3. Verify -- Check output file for formatting fidelity

Key Rules:

  • Requires pandoc installed on the system
  • Supports GFM tables, code blocks, and images
  • Optional reference.docx template for custom styling

Be skeptical. Apply critical thinking, sequential thinking. Every claim needs traced proof, confidence percentages (Idea should be more than 80%).

markdown-to-docx

Convert markdown files to editable Microsoft Word documents with support for tables, code blocks, images, and LaTeX math equations.

Installation Required

This skill requires npm dependencies. Run one of:

# Option 1: ClaudeKit CLI (recommended)
ck init

# Option 2: Manual
cd .claude/skills/markdown-to-docx
npm install

Dependencies: markdown-docx, gray-matter

Quick Start

# Basic conversion
node .claude/skills/markdown-to-docx/scripts/convert.cjs --input ./README.md

# Specify output path
node .claude/skills/markdown-to-docx/scripts/convert.cjs -i ./doc.md -o ./output.docx

# With custom theme
node .claude/skills/markdown-to-docx/scripts/convert.cjs -i ./doc.md --theme ./theme.json

CLI Options

| Option | Short | Description | Default | | ---------- | ----- | ------------------- | -------------- | | --input | -i | Input markdown file | (required) | | --output | -o | Output DOCX path | {input}.docx | | --theme | -t | Custom theme JSON | built-in | | --title | | Document title | filename | | --help | -h | Show help | |

Features

  • GFM Support: Tables, strikethrough, task lists
  • Code Blocks: Syntax preserved with monospace font
  • Images: Local and URL images embedded
  • Math: LaTeX equations rendered by default ($...$, $$...$$)
  • Frontmatter: YAML metadata extracted for title
  • No System Dependencies: Pure JavaScript, no Chrome needed

Output

Returns JSON on success:

{
    "success": true,
    "input": "/path/to/input.md",
    "output": "/path/to/output.docx"
}

Compatibility

Generated DOCX files work with:

  • Microsoft Word (2007+)
  • Google Docs (upload to Drive)
  • LibreOffice Writer
  • Apple Pages

Closing Reminders

  • IMPORTANT MUST ATTENTION break work into small todo tasks using TaskCreate BEFORE starting
  • IMPORTANT MUST ATTENTION search codebase for 3+ similar patterns before creating new code
  • IMPORTANT MUST ATTENTION cite file:line evidence for every claim (confidence >80% to act)
  • IMPORTANT MUST ATTENTION add a final review todo task to verify work quality