AgentSkillsCN

pdf-to-markdown

将 PDF 文件转换为 Markdown 格式

SKILL.md
--- frontmatter
name: pdf-to-markdown
description: Convert PDF files to Markdown format
metadata:
  author: Zo
  category: Official
  display-name: Convert PDF to Markdown
  emoji: 📄

Convert PDF to Markdown

Purpose

Convert the user's PDF file to Markdown format, preserving structure and formatting.

Input

  • •Path to the PDF file you want to convert

Steps

  1. •Install pymupdf4llm if not already installed:
bash
pip install pymupdf4llm
  1. •Convert the user's PDF to Markdown with proper formatting:
python
import pymupdf4llm

# Convert with better formatting and structure preservation
markdown_text = pymupdf4llm.to_markdown(
    "<user's_pdf_path>",
    page_chunks=True,  # Separate pages with breaks
    write_images=True  # Extract and include images
)

# Save to a markdown file with the same name
output_filename = "<user's_pdf_path>".replace('.pdf', '.md')
with open(output_filename, "w", encoding="utf-8") as f:
    f.write(markdown_text)
  1. •Tell the user where the converted markdown file was saved.

Note

If the PDF appears to be scanned (images of text), inform the user that OCR tools would work better for that use case.