oma-pdf

Convert PDF documents into structured Markdown for LLM and RAG use.

46|2|Updated Mar 23, 2025
One-click install
npx skills add https://github.com/gracefullight/krds --skill oma-pdf-gracefullight
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oma-pdf
Source: https://github.com/gracefullight/krds/tree/main/.agents/skills/oma-pdf
Command: npx skills add https://github.com/gracefullight/krds --skill oma-pdf-gracefullight

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill eliminates the manual effort of reading and restructuring PDF documents by converting them into readable, structured Markdown suitable for LLM context, RAG pipelines, review, and downstream processing.

Core Features & Use Cases

  • PDF to Markdown extraction: Converts PDFs into structured Markdown while preserving document reading order, including headings, lists, tables, and images.
  • Hybrid conversion for scanned PDFs: Detects when a PDF lacks a strong text layer and switches to OCR/hybrid extraction to recover content.
  • Markdown normalization: Runs Markdown formatting to produce consistent, normalized output that is easier to consume and search.

Quick Start

Use this Skill to convert the file at input_path into Markdown in output_dir for AI-ready document extraction and review.

Frequently Asked Questions about oma-pdf

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert PDF to Markdown for LLM context and RAG pipelines?

To convert PDF to Markdown for LLM context, the tool extracts structured text, headings, lists, and tables while preserving reading order. It then normalizes the Markdown output, making it ready for downstream RAG ingestion.

Can I extract tables from scanned PDFs using OCR?

Yes, you can extract tables from scanned PDFs using OCR. The tool detects when a PDF lacks a strong text layer and automatically switches to hybrid OCR extraction to recover content from image-based documents.

What is the best way to batch convert multiple PDFs into structured Markdown?

The best way to batch convert PDFs is to point the tool at a folder directory. It validates input paths and processes the entire batch, applying standard or hybrid OCR strategies to generate normalized Markdown output.

Does PDF to Markdown extraction preserve document reading order?

PDF to Markdown extraction preserves document reading order. The conversion process maintains the logical sequence of headings, lists, tables, and images, ensuring the structured Markdown remains coherent for downstream LLM processing.

How does Markdown normalization improve extracted PDF text?

Markdown normalization improves extracted PDF text by running formatting tools to produce consistent, standardized output. This normalized text is easier to consume, search, and process within downstream AI review and retrieval systems.

Do I need a separate tool for tagged-text PDF extraction?

No, you do not need a separate tool for tagged-text PDF extraction. The tool automatically chooses between standard, tagged, and hybrid OCR strategies based on the PDF's structure and text layer quality.