Heading from pdf

[roninio]

I have a PDF document containing headings of various sizes and styles. After converting the PDF to a Markdown file using DocLing, I've noticed that all headings are uniformly converted to level-2 headings (##), regardless of their original size or importance in the PDF.

I would like to know how to properly configure DocLing, or if there's an alternative method, to accurately represent the original heading hierarchy from the PDF in the resulting Markdown file. Specifically, I need the Markdown headings to reflect the relative size and importance of the headings in the original PDF (e.g., larger headings should become #, smaller headings ###, etc.).

Could you please provide information on how to achieve this? Thank you."

[kaumnen]

PyMuPDF has a get_toc [0] method that returns a table of contents

a quick example of returned ToC with simple=True (more info in the linked docs):

[
    [1, "Heading 1", 22],
    [2, "Heading 2", 33],
    [3, "Heading 3", 44],
    [4, "Another heading 4", 55]
]

elements format:
[<heading level>, <heading text>, <page its on>]

what you can do is:

1. convert the pdf and .export_to_markdown() [1]
2. open the same pdf file with PyMuPDF, extract ToC
3. go through the markdown, check and update (add or remove) # where needed based on the <heading level> from the ToC

---

[0]: https://pymupdf.readthedocs.io/en/latest/document.html#Document.get_toc

[1]: https://docling-project.github.io/docling/reference/docling_document/#docling_core.types.doc.DoclingDocument.export_to_markdown

[PeterStaar-IBM]

@roninio Note that the docling-parse can also provide the TOC and populate it (see here: https://github.com/docling-project/docling-core/blob/763e1364ff0b95388696ccd3d69f150718012a3a/docling_core/types/doc/page.py#L463).

We plan to propagate this info and use it to improve the heading tree.

[JohannKaspar]

Looking forward to this feature!