Skip to content
Skills Library
Documents & office · Conversion & formats

do.pdf-to-markdown

/do.pdf-to-markdown

Convert PDF documents to high-fidelity Markdown with checkpointed page and section coverage verification. Use when the user asks to convert, transcribe, extract, or preserve a PDF as Markdown, especially for papers containing formulas, tables, figures, or multi-column layouts.

Repository
deeporbit ↗
Licence
MIT
Last repository change
08.10.2026

Assessment and security

95/ 100Class: good
Format20 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
1
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 08.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 1 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: scripts/extract_images.py

What it does and when to use it

Convert PDF documents to high-fidelity Markdown with checkpointed page and section coverage verification. Use when the user asks to convert, transcribe, extract, or preserve a PDF as Markdown, especially for papers containing formulas, tables, figures, or multi-column layouts.

Original author description

Convert PDF documents to high-fidelity Markdown with checkpointed page and section coverage verification. Use when the user asks to convert, transcribe, extract, or preserve a PDF as Markdown, especially for papers containing formulas, tables, figures, or multi-column layouts.

How it works

  1. 1. Build the manifest
  2. 2. Convert with checkpoints
  3. 3. Verify the whole document
  4. 4. Final output
Original SKILL.md headings · 78 lines, 408 words
SKILL.md preview
---
name: do.pdf-to-markdown
description: Convert PDF documents to high-fidelity Markdown with checkpointed page and section coverage verification. Use when the user asks to convert, transcribe, extract, or preserve a PDF as Markdown, especially for papers containing formulas, tables, figures, or multi-column layouts.
---

# PDF to Markdown

Preserve the source language and document structure. Use visual PDF reading for formulas, tables, and reading order; do not trust blind text extraction for complex layouts.

## 1. Build the manifest

Inspect the full PDF and write `<name>_manifest.md` beside it:

```markdown
---
deeporbit_workflow: 1
workflow_id: pdf-<date>-<slug>
status: active
source: <name>.pdf
output: <name>.md
---

# Conversion Manifest
- Total pages: N
- [ ] Cover and metadata (p.1)
- [ ] Abstract (p.1-2)
- [ ] Section 1 (p.2-5)
- [ ] References (p.N-2-N)
- Tables: T
- Figures: F
```

Every page must belong to a checklist item. If bundled image extraction is available, run:

```bash
python <skill-dir>/scripts/extract_images.py <input.pdf>
```

PyMuPDF is optional and is used only for embedded images, never as the sole text source.

## 2. Convert with checkpoints

For each unchecked section:

1. Visually read its page range.
2. Append it to `<name>.md` in reading order.
3. Preserve headings, paragraph breaks, lists, fenced code, footnotes, tables, and emphasis.
4. Transcribe math as `$...$` or `$$...$$`.
5. Reference extracted images with relative paths and source captions.
6. Compare paragraph, table, figure, and page coverage.
7. Mark that section checked only after its verification succeeds.

Continue in the same turn when feasible. If interrupted or context-limited, reread the manifest and resume at the first unchecked item. A runtime Goal or Tracker may mirror the overall objective, but the manifest remains authoritative. Do not use an external self-invoking loop.

## 3. Verify the whole document

- All manifest entries are checked.
- Every page is covered exactly once or its overlap is explained.
- Output headings match the source section list.
- Table and figure counts match.
- Code, math, links, and footnotes are intact.
- No source paragraphs were silently omitted.

Add a final conversion report with page, section, table, figure, image, and word counts. Keep the manifest when an audit trail is useful; otherwise ask before deleting it.

## 4. Final output

Write frontmatter at line 1:

```yaml
---
type: note
title: "<Document Title>"
source: "[[<name>.pdf]]"
created: YYYY-MM-DD
tags: [pdf-conversion]
---
```

- Set `author: ai` in frontmatter for every note you create; switch to `author: mixed` when substantially rewriting a human-authored note. Authorship lives in frontmatter only — never add visible badges.
Save beside the PDF, link relevant existing Wiki concepts when appropriate, and use `do.obsidian-open` to present the result. Failure to open the desktop app does not invalidate the conversion.
Files in this package (2)
  • SKILL.md 3 KB
  • scripts/extract_images.py 1 KB

Versions

The database has no other skills named do.pdf-to-markdown.

Database snapshot: 13.11.2026 · package version c9ad8cf92014 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 2 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100markdown-to-pdf
    Use when asked to turn a Markdown file into a PDF, export a .md report for printing or sharing, or produce a printable deliverable from Markdown, especially documents containing mermaid diagrams, wide tables, or that need page numbers and a running header.
  • 100pdf-to-markdown
    Convert PDF to clean Markdown with image content described as text. Use when user wants to convert a PDF to markdown, extract content from PDF, or prepare PDF content for AI tools.
  • 100md-to-pdf
    Convert Markdown to styled PDFs with Mermaid diagrams, LaTeX/KaTeX math, tables, and code highlighting. Triggers on: "convert markdown to pdf", "make a pdf from this md", "export markdown as pdf", "pdf from markdown with equations".
  • 100pdf-to-md
    Convert PDF documents to Markdown using a local docling + RapidOCR setup. Use this whenever the user wants to turn a PDF into Markdown or plain text — extract text/tables/headings from a PDF, get a PDF's content as .md, prep a PDF for an LLM or RAG pipeline, OCR a scanned PDF to…
  • 100pdf-to-markdown
    Converts PDF files to structured Markdown with automatic mode selection. Supports simple text extraction (fast) and complex layouts with code/tables (vision). Triggers when the user wants to convert a PDF document, extract PDF content, or transform PDF to Markdown format.
  • 100md-to-pdf
    Convert any markdown file to a clean PDF. Use when asked to make a PDF from a .md file, export a document, or convert markdown to PDF.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.