microsoft / microsoft/markitdown

PDF L1/L2 headers

Open
#304 0 comments 13 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
186k
Forks
13.7k
Avg merge
1d 4h
Merged PRs (30d)
49

Description

The library doesn't seem to create any headers when creating markdown from PDF documents. Without a header, there is nothing to delineate sections in the document, which is an important function for LLM chunking.

Any plans to add L1/L2 headers to markitdown?

Alternate implementations for PDF parsing

It seems that PDFPlumber and/or PyMuPDF might have better semantic awareness and might be better at preserving headers and such. Would there be any interest in exploring alternative libraries?

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

No files, tests, or entry points are named in the issue. First locate the PDF conversion path and determine how the current parser represents section headings, then assess the suggested PDFPlumber or PyMuPDF alternatives. Done means PDF-to-Markdown output preserves appropriate L1/L2 headers and includes tests covering the resulting structure.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
tooling
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.