Convert PDF/EPUB/PPTX/DOCX/XLSX to Markdown using marker-pdf with LLM enhancement.

Install

/plugin install marker@xdanger-plugins

Run it inside Claude Code after adding the marketplace with /plugin marketplace add xdanger/claude-plugins.

Contents

Discovered from source

Skills 1

Marker Document Converter

Convert PDF, EPUB, PPTX, DOCX, XLSX, HTML, and image files to clean Markdown/JSON/HTML format using the marker-pdf tool with multimodal LLM enhancement.

Prerequisites

# Install marker-pdf with full document support
uv tool install marker-pdf[full]

Requires Python 3.10+ and PyTorch.

Basic Usage

marker_single "<file_path>" \
  --output_format markdown \
  --output_dir "<output_directory>" \
  --use_llm \
  --llm_service marker.services.claude.ClaudeService \
  --claude_model_name claude-haiku-4-5 \
  --claude_api_key $ANTHROPIC_API_KEY \
  --disable_image_extraction

Note: --disable_image_extraction generates plain text output. Remove this flag if images need to be preserved.

Output Formats

FormatDescriptionUse Case
markdownFormatted text with tables, LaTeX equations ($$-fenced), code blocks, image linksGeneral document conversion
htmlSemantic HTML with <img>, <math>, <pre> tagsWeb display
jsonHierarchical structure with block types, bounding boxes, section hierarchyProgrammatic processing
chunksFlattened JSON optimized for RAGVector database ingestion

CLI Options

Core Options

  • --output_format: markdown (default), html, json, chunks
  • --output_dir: Directory for output files
  • --page_range: Specific pages, e.g., "0,5-10,20"

LLM Enhancement

  • --use_llm: Enable LLM for improved accuracy (tables, forms, math, handwriting)
  • --llm_service: LLM service class (see LLM Services below)
  • --block_correction_prompt: Custom prompt for output refinement

OCR & Processing

  • --force_ocr: Force OCR on entire document, converts inline math to LaTeX
  • --strip_existing_ocr: Remove existing OCR and re-process
  • --redo_inline_math: Highest quality inline math conversion (use with --use_llm)

Image & Output Control

  • --disable_image_extraction: Skip image extraction (plain text only)
  • --paginate_output: Add page separators to output
  • --extract_images: Enable image extraction (default: true)

Advanced

  • --config_json: Load configuration from JSON file
  • --debug: Enable diagnostic logging
  • --force_layout_block: Force layout type, e.g., Table
  • --converter_cls: Custom converter class

LLM Services

Claude (Default)

marker_single document.pdf \
  --use_llm \
  --llm_service marker.services.claude.ClaudeService \
  --claude_api_key $ANTHROPIC_API_KEY \
  --claude_model_name claude-haiku-4-5

OpenAI

marker_single document.pdf \
  --use_llm \
  --llm_service marker.services.openai.OpenAIService \
  --openai_api_key $OPENAI_API_KEY \
  --openai_model gpt-4o

Ollama (Local)

marker_single document.pdf \
  --use_llm \
  --llm_service marker.services.ollama.OllamaService \
  --ollama_base_url "http://localhost:11434" \
  --ollama_model llama3.2-vision

Google Gemini (Default if no service specified)

export GOOGLE_API_KEY="your-api-key"
marker_single document.pdf --use_llm

Examples

Convert PDF to Markdown (Plain Text)

marker_single "./docs/report.pdf" \
  --output_format markdown \
  --output_dir "./docs/" \
  --use_llm \
  --llm_service marker.services.claude.ClaudeService \
  --claude_model_name claude-haiku-4-5 \
  --claude_api_key $ANTHROPIC_API_KEY \
  --disable_image_extraction

Convert with Images Preserved

marker_single "./docs/report.pdf" \
  --output_format markdown \
  --output_dir "./docs/" \
  --use_llm \
  --llm_service marker.services.claude.ClaudeService \
  --claude_model_name claude-haiku-4-5 \
  --claude_api_key $ANTHROPIC_API_KEY

Extract Tables Only

marker_single "./docs/spreadsheet.pdf" \
  --use_llm \
  --force_layout_block Table \
  --converter_cls marker.converters.table.TableConverter \
  --output_format json

Batch Convert Multiple Files

marker /path/to/input/folder --workers 4

Using JSON Config File

cat > config.json << EOF
{
  "force_ocr": true,
  "use_llm": true,
  "output_format": "markdown",
  "disable_image_extraction": true,
  "strip_existing_ocr": true,
  "redo_inline_math": true
}
EOF

marker_single document.pdf --config_json config.json

Output Structure

Markdown Output

  • Image links: ![](image_name.png)
  • Tables: Formatted as markdown tables
  • Equations: Fenced with $$...$$
  • Code: Fenced with ```language
  • Headings: # for sections

JSON Output

{
  "pages": [
    {
      "id": "page_0",
      "polygon": [[x1,y1], [x2,y2], ...],
      "children": [
        {
          "id": "block_0",
          "block_type": "Text|Table|Image|...",
          "html": "<p>content</p>",
          "polygon": [...],
          "section_hierarchy": {...}
        }
      ]
    }
  ],
  "metadata": {
    "table_of_contents": [...],
    "page_stats": [...]
  }
}

Instructions

  1. Confirm the input file path exists

  2. Determine output directory (default: same as input file)

  3. Use AskUserQuestion tool to ask user preferences (ask both questions together):

    Question 1 - Image Extraction:

    • Header: "Images"
    • Question: "是否需要提取文档中的图片?"
    • Options:
      • "No (Recommended)": 仅提取文本,生成纯 Markdown 文件
      • "Yes": 提取图片并保存,Markdown 中包含图片链接

    Question 2 - LLM Service:

    • Header: "LLM"
    • Question: "使用哪个 LLM 来识别图片和表格内容?"
    • Options:
      • "Claude Haiku (Recommended)": 快速、经济,需要 ANTHROPIC_API_KEY
      • "Claude Sonnet": 更高质量,需要 ANTHROPIC_API_KEY
      • "GPT-4o": OpenAI 模型,需要 OPENAI_API_KEY
      • "Ollama (Local)": 本地运行,无需 API Key
  4. Based on user's answers, construct the command:

    • If "No" for images: add --disable_image_extraction
    • Set LLM service parameters according to selection:
      • Claude Haiku: --llm_service marker.services.claude.ClaudeService --claude_model_name claude-haiku-4-5 --claude_api_key $ANTHROPIC_API_KEY
      • Claude Sonnet: --llm_service marker.services.claude.ClaudeService --claude_model_name claude-sonnet-4-20250514 --claude_api_key $ANTHROPIC_API_KEY
      • GPT-4o: --llm_service marker.services.openai.OpenAIService --openai_api_key $OPENAI_API_KEY --openai_model gpt-4o
      • Ollama: --llm_service marker.services.ollama.OllamaService --ollama_base_url "http://localhost:11434" --ollama_model llama3.2-vision
  5. Run the marker_single command with chosen options

  6. Report the output file location and any extraction notes

Sponsors

Details

Marketplace
xdanger/claude-plugins
Source
plugins/marker
Category
Community

More from xdanger/claude-plugins

All 5