Skip to main content
Business & Productivityreggiechan74

convert-to-word

Convert markdown documents to professional Word DOCX format using pandoc

Stars
19
Source
reggiechan74/JobOps
Updated
2026-05-29
Slug
reggiechan74--JobOps--convert-to-word
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/reggiechan74/JobOps/HEAD/plugins/jobops/skills/convert-to-word/SKILL.md -o .claude/skills/convert-to-word.md

Drops the SKILL.md into .claude/skills/convert-to-word.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

I'll convert your specified markdown documents to professional Word DOCX format using pandoc.

Arguments:

  • $1: File path or glob pattern to convert (required, absolute or relative to workspace)
    • Specific file: Applications/AcmeCorp_Director_2026-04-23/resume/step3_final.md
    • Pattern: Applications/AcmeCorp_Director_2026-04-23/resume/*.md
    • Pattern across applications: Applications/*/resume/step3_final.md
  • $2: Output directory (optional, defaults to the same directory as each source file)

Supported Conversion Patterns:

Single File Conversion

/convert Applications/AcmeCorp_Director_2026-04-23/resume/step3_final.md
/convert Applications/FinCo_VP_2026-04-23/cover-letter/cover_letter.md
/convert Career_Analysis/idealjob_20260423.md

Pattern-Based Conversion

/convert "Applications/*/resume/step3_final.md"
/convert "Applications/AcmeCorp_Director_2026-04-23/*.md"
/convert "Crisis_Management/severance_review_*.md"

With Custom Output Directory

/convert Applications/AcmeCorp_Director_2026-04-23/resume/step3_final.md ~/Desktop/

Step 1: System Verification

First, I'll check if pandoc is installed and ready:

Step 2: File Discovery and Validation

I'll locate and validate the specified files based on your input pattern: @$1

Path resolution:

  • Absolute paths are used verbatim.
  • Relative paths are resolved against the current working directory.
  • Glob patterns are expanded before conversion.

Step 3: Direct Conversion Process

I'll convert the files directly using pandoc in the main shell session:

Conversion Features:

  • Professional Formatting: Clean, business-appropriate styling
  • Table Preservation: Requirements tables in cover letters render correctly
  • Font Optimization: Uses standard professional fonts (Calibri, Arial)
  • Layout Optimization: Proper spacing, margins, and page breaks
  • ATS Compatibility: Ensures compatibility with applicant tracking systems

Quality Checks:

  • Verify pandoc conversion completed successfully
  • Check DOCX file integrity and size
  • Validate table formatting (especially requirements matrices)
  • Ensure proper character encoding
  • Confirm professional appearance

File Organization:

  • Original .md files remain unchanged
  • New .docx files created with matching names
  • Output directory defaults to the source file's own directory
  • Clear success/error reporting

Implementation

I'll execute the conversion using these steps:

  1. Verify pandoc installation
  2. Find matching files using glob patterns
  3. Convert each file using pandoc with professional formatting options
  4. Verify successful conversion and report results

Enhanced Pandoc command used:

pandoc "input.md" -o "input.docx" \
  --from markdown \
  --to docx \
  --standalone \
  --wrap=none \
  --metadata title="Professional Resume" \
  --highlight-style=monochrome \
  --metadata margin-top=1in \
  --metadata margin-bottom=1in \
  --metadata margin-left=1in \
  --metadata margin-right=1in

Professional formatting targets:

  • Length: Target 3-page maximum (like reference PDF)
  • Bullet Points: Clean rendering without line break issues
  • Typography: Professional fonts and consistent spacing
  • Margins: Standard 1-inch margins for business documents
  • Layout: Compact but readable, matching industry standards

Formatting options applied:

  • --standalone: Complete document structure
  • --wrap=none: Prevents bullet point formatting issues
  • --highlight-style=monochrome: Professional appearance
  • --metadata: Sets margins and document properties
  • Target output matches 3-page reference PDF format

Expected Output

Your documents will be converted with these naming patterns:

  • step3_final.md -> step3_final.docx
  • cover_letter.md -> cover_letter.docx
  • idealjob_20260423.md -> idealjob_20260423.docx

Output location defaults to the same directory as the source file (e.g. a file under Applications/AcmeCorp_Director_2026-04-23/resume/ emits its .docx alongside the .md). Pass $2 to override.

Professional Formatting Applied

The converted documents feature:

  • Resumes: Single-page optimization, professional fonts, consistent bullet styling
  • Cover Letters: Business format, properly formatted requirements tables, signature space
  • Both: Clean margins, appropriate spacing, ATS-friendly formatting

Success Verification

After conversion, I'll verify:

  • DOCX files created successfully
  • File sizes are reasonable
  • Professional formatting preserved

Your markdown documents will be transformed into professional Word documents ready for employer submission while preserving all the strategic content and formatting from your carefully crafted application materials.