Name: markdown-tools
Author: wonderslife

Imported from wonderslife/college-major4hs (.trae/skills/markdown-tools/SKILL.md). Install upstream with npx skills add wonderslife/college-major4hs --skill markdown-tools. Copyright stays with the author.

Markdown Tools

Convert documents to markdown with image extraction and Windows/WSL path handling.

Quick Start

Install markitdown with PDF Support

# IMPORTANT: Use [pdf] extra for PDF support
uv tool install "markitdown[pdf]"

# Or via pip
pip install "markitdown[pdf]"

Basic Conversion

markitdown "document.pdf" -o output.md
# Or redirect: markitdown "document.pdf" > output.md

PDF Conversion with Images

markitdown extracts text only. For PDFs with images, use this workflow:

Step 1: Convert Text

markitdown "document.pdf" -o output.md

Step 2: Extract Images

# Create assets directory alongside the markdown
mkdir -p assets

# Extract images using PyMuPDF
uv run --with pymupdf python scripts/extract_pdf_images.py "document.pdf" ./assets

Step 3: Add Image References

Insert image references in the markdown where needed:

![Description](assets/img_page1_1.png)

Step 4: Format Cleanup

markitdown output often needs manual fixes:

Add proper heading levels (#, ##, ###)
Reconstruct tables in markdown format
Fix broken line breaks
Restore indentation structure

Path Conversion (Windows/WSL)

# Windows → WSL conversion
C:\Users\name\file.pdf → /mnt/c/Users/name/file.pdf

# Use helper script
python scripts/convert_path.py "C:\Users\name\Documents\file.pdf"

Common Issues

"dependencies needed to read .pdf files"

# Install with PDF support
uv tool install "markitdown[pdf]" --force

FontBBox warnings during PDF conversion

These are harmless font parsing warnings, output is still correct

Images missing from output

Use scripts/extract_pdf_images.py to extract images separately

Resources

scripts/extract_pdf_images.py - Extract images from PDF using PyMuPDF
scripts/convert_path.py - Windows to WSL path converter
references/conversion-examples.md - Detailed examples for batch operations

{ "ocm": "1", "id": "wonderslife-college-major4hs-markdown-tools", "kind": "skill", "name": "markdown-tools", "description": "Converts documents to markdown (PDFs, Word docs, PowerPoint, Confluence exports) with Windows/WSL path handling. Activates when converting .doc/.docx/PDF/PPTX files to markdown, processing Confluence exports, handling Windows/WSL path conversions, extracting images from PDFs, or working with markitdown utility.", "publisher": "wonderslife", "version": "1.0.0", "capabilities": { "domains": [ "coding" ], "tags": [ "skill-md", "github" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Converts documents to markdown (PDFs, Word docs, PowerPoint, Confluence exports) with Windows/WSL path handling. Activates when converting .doc/.docx/PDF/PPTX files to markdown, processing Confluence exports, handling Windows/WSL path conversions, extracting images from PDFs, or working with markitdown utility." ], "primary": false, "metadata": { "source": { "provider": "github", "repository": "https://github.com/wonderslife/college-major4hs", "path": ".trae/skills/markdown-tools/SKILL.md", "ref": "54c03d0286ef920ecca5ec625734669233238b43", "url": "https://github.com/wonderslife/college-major4hs/blob/54c03d0286ef920ecca5ec625734669233238b43/.trae/skills/markdown-tools/SKILL.md", "key": "wonderslife/college-major4hs/.trae/skills/markdown-tools/SKILL.md" } }, "instructions": "# Markdown Tools\n\nConvert documents to markdown with image extraction and Windows/WSL path handling.\n\n## Quick Start\n\n### Install markitdown with PDF Support\n\n```bash\n# IMPORTANT: Use [pdf] extra for PDF support\nuv tool install \"markitdown[pdf]\"\n\n# Or via pip\npip install \"markitdown[pdf]\"\n```\n\n### Basic Conversion\n\n```bash\nmarkitdown \"document.pdf\" -o output.md\n# Or redirect: markitdown \"document.pdf\" > output.md\n```\n\n## PDF Conversion with Images\n\nmarkitdown extracts text only. For PDFs with images, use this workflow:\n\n### Step 1: Convert Text\n\n```bash\nmarkitdown \"document.pdf\" -o output.md\n`", "cost": { "context_tokens": 495 } }

markdown-tools

About