pdf2md SKILL.md skillA

pdf2md from dimonier/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add dimonier/skills/pdf2md@git:20260714.5777904

Pins git:20260714.5777904 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
dimonier/skills
Path
skills/pdf2md/SKILL.md
Versions recorded
1
Latest version
git:20260714.5777904, committed Jul 14, 2026
Size
4,757 bytes
Repository stars
10
License
a license file GitHub does not identify

Convert PDF files to Markdown — extracts text with pdfplumber and describes images/diagrams via a local vision-language model. Use when the user asks to extract PDF content, convert presentation slides to text, transcribe conference talks from PDFs, or OCR diagrams and charts from documents.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# PDF -> Markdown (pdf2md)

Extracts PDF content into Markdown: text as-is + image/diagram meaning via a Vision Language Model.

## When to Use

- User asks to "extract from PDF", "convert PDF to text/Markdown", "transcribe slides"
- Presentation decks (text + graphics + diagrams)
- Conference talks, workshops, technical reports
- PDFs where plain text extraction produces garbled output

## When NOT to Use

- PDFs that are purely text (use pdfplumber directly — faster, no VL needed)
- One-page forms or invoices (use pdfplumber tables)
- Filling PDF forms (use well known `pdf` skill instead)
- Scanned documents without selectable text (this skill works, but OCR-only tools may be faster)

## Dependencies

Install once per environment:

```bash
pip install pdfplumber pypdfium2 pillow requests
```

## VL Model Setup

Default: **LM Studio** with `qwen/qwen3-vl-8b` loaded on `localhost:1234`.

Any OpenAI-compatible endpoint works — Ollama, vLLM, cloud providers. To switch:

```bash
python scripts/extract_pdfs.py --source "<path>" --model "llama3.2-vision" --api-url "http://localhost:11434/v1/chat/completions"
```

## Workflow

### Step 1: Verify VL model is reachable

```bash
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add dimonier/skills/pdf2md@sha256:d2f7104627e021e1

The line at the top of this page pins the label git:20260714.5777904, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_syqebjvqtl6kpkos.svg)](https://markdownregistry.com/a/art_syqebjvqtl6kpkos)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Jul 14, 2026.

versioncommittedcommitsizeaudit
git:20260714.5777904 latest2026-07-14 5777904 4,757 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4757 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

dimonier/skills · 10 stars · license a license file GitHub does not identify · pushed 2026-10-18 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_syqebjvqtl6kpkos
GET https://markdownregistry.com/api/v1/resolve?ref=dimonier/skills/pdf2md
GET https://markdownregistry.com/api/v1/blob/d2f7104627e021e111d90decafe989f0ad1ddbe966a330c632dd2d8884199197

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from dimonier/skills

dpf-business-analysis SKILL.md skill
dimonier/skills · skills-compact/business-analysis/SKILL.md · Business Analysis & Requirements Engineering (compacted runtime projection). Use when: identifying stakeholders…
git:20261012.6a7711e · audit A · 10 stars
episteme-compaction SKILL.md skill
dimonier/skills · skills-compact/episteme-compaction/SKILL.md · Lossless compaction of epistemes: prose ↔ compact typed-slot notation (F4-F5; ~65% median token savings, measured on…
git:20261018.b2b1b02 · audit A · 10 stars
pattern-language-as-agent-skill SKILL.md skill
dimonier/skills · skills-compact/pattern-language-as-agent-skill/SKILL.md · Compacted runtime projection of the Pattern Language as Agent Skill (PLAS) LPF. Author and improve a Domain Principle…
git:20261018.b2b1b02 · audit A · 10 stars
project-vault SKILL.md skill
dimonier/skills · skills-compact/project-vault/SKILL.md · Maintains project state in a markdown vault: a single decision card carrying decisions, questions, risks…
git:20261002.ba57422 · audit A · 10 stars
agent-skill-builder SKILL.md skill
dimonier/skills · skills/agent-skill-builder/SKILL.md · Guide for deciding when to create agent skills, how to design them well, and what anti-patterns to avoid. Use when: (1)…
git:20261012.6a7711e · audit A · 10 stars
bathroom-planner SKILL.md skill
dimonier/skills · skills/bathroom-planner/SKILL.md · Structured 10-stage methodology for planning bathroom layouts with focus on ergonomics, functionality, and safety. Use…
git:20260123.8ce21c1 · audit A · 10 stars
dpf-business-analysis SKILL.md skill
dimonier/skills · skills/dpf-business-analysis/SKILL.md · Business Analysis & Requirements Engineering. Use when: identifying stakeholders, eliciting or specifying requirements…
git:20261012.6a7711e · audit A · 10 stars
dpf-lfw-architecture SKILL.md skill
dimonier/skills · skills/dpf-lfw-architecture/SKILL.md · LFW Architecture. Use when: organizing the FPF/DPF/LPF workspace, deciding where to place a new framework, setting up…
git:20260628.419626c · audit A · 10 stars
episteme-compaction SKILL.md skill
dimonier/skills · skills/episteme-compaction/SKILL.md · Lossless compaction of epistemes: prose ↔ compact typed-slot notation (F4-F5; ~65% median token savings, measured on…
git:20261018.b2b1b02 · audit A · 10 stars
fpf-core SKILL.md skill
dimonier/skills · skills/fpf-core/SKILL.md · First Principles Framework core patterns. Use when doing engineering, research, management, or mixed human/AI work…
git:20261013.a0d7dc5 · audit A · 10 stars
fpf-sync SKILL.md skill
dimonier/skills · skills/fpf-sync/SKILL.md · Sync the fpf-core skill from the canonical FPF-Spec.md monolith. Use when: (1) the FPF specification has been updated…
git:20260724.0bf2f18 · audit A · 10 stars
pattern-language-as-agent-skill SKILL.md skill
dimonier/skills · skills/pattern-language-as-agent-skill/SKILL.md · Author and improve a Domain Principle Framework (DPF) or Local Practices Framework (LPF) directly in Agent-skill form…
git:20261018.b2b1b02 · audit A · 10 stars

Every file in dimonier/skills

Other files named pdf2md

pdf2md SKILL.md skill
renky1025/agent-skills · pdf2md/SKILL.md · 将任意 PDF 高质量转换为 Markdown(保留表格、LaTeX 公式、图片、多栏布局与标题层级),基于 OpenDataLoader PDF(Benchmark #1 准确率);支持单文件与批量文件夹、fast/hybrid…
v1.0.0 · audit A · 11 stars

Browse by kind, by grade A, or by owner.