Who it is forA technical writer or course developer whose source material is mostly flowcharts, diagrams, and charts.
The problemFigures are usually left as empty placeholders, so the knowledge inside them cannot be searched or read by a text-only model.
The outcomeA Markdown document in which each figure's content is written as text beside its caption, so the material can be searched and reused without sending images to a model again.
What you need first
- Python installed on Windows, Linux, or macOS
- git installed to clone the repository
- A supported AI agent that can load the skill (the README names Claude Code and Codex)
- The PDF file to convert, with the page range you want
- A host model that can understand images, since transcription quality depends on it
Steps
- Clone the skill into your agent's skills directory, for example
git clone https://github.com/libnyx/LT2MD.git ~/.claude/skills/LT2MDon macOS or Linux with Claude Code. - Ask the agent to convert the PDF in batches and write a text description next to every flowchart, diagram, and chart.
- Check a sample of figure descriptions against the rendered page for labels, arrow directions, and subfigures.
- Load the final Markdown into your search or documentation tool and confirm that figure content is findable by text.
Prompt for your agent
Use the LT2MD skill in the libnyx/LT2MD repo to convert <path to PDF> to Markdown, writing the content of every flowchart, diagram, and chart as text beside its caption and labeling each block with its PDF page. Expected output: one Markdown file; verify that three figure descriptions match their source pages, including arrow directions and labels.
Caveat. Figure descriptions are the transcriber's supplement and depend on the host model's image understanding, so verify complex diagrams against the page.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for libnyx/LT2MD and "Turn a diagram-heavy PDF into a searchable Markdown base"
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer