pdf-to-markdown

Installation Required

cd .claude/skills/pdf-to-markdown
npm install

pdf-parse

Quick Start

# Basic conversion
node .claude/skills/pdf-to-markdown/scripts/convert.cjs \
  --file ./document.pdf

# Custom output path
node .claude/skills/pdf-to-markdown/scripts/convert.cjs \
  --file ./doc.pdf \
  --output ./output/doc.md

CLI Options

--file <path>

--output <path>

Output Format (JSON)

{
  "success": true,
  "input": "/path/to/input.pdf",
  "output": "/path/to/output.md",
  "wordCount": 1523,
  "warnings": ["Tables may not be accurately converted"]
}

Supported Elements

• Text extraction from digital PDFs
• Headings (detected by font size heuristics)
• Paragraphs
• Basic lists
• Links (when embedded in PDF)

Known Limitations

• Tables: Very limited support; may not render correctly
• Multi-column layouts: Text may interleave between columns
• Scanned PDFs: NOT supported (requires OCR - see alternatives below)
• Images: NOT extracted (PDF images are not included in output)
• Complex formatting: May be simplified or lost
• Password-protected PDFs: NOT supported

Alternatives for Unsupported Cases

• Use

  scribe.js-ocr

  library (AGPL license)
• Commercial OCR services (Google Cloud Vision, AWS Textract)

• Consider AI-based extraction (LLM post-processing)
• Manual review and correction

• Use

  unpdf

  library with

  sharp

  for image extraction
• Process images separately and reference in markdown

Troubleshooting

npm install

--max-old-space-size=4096

IMPORTANT Task Planning Notes

• Always plan and break many small todo tasks
• Always add a final review todo task to review the works done at the end to find any fix or enhancement needed