docling-project/docling

Markdown serialization of headings in rich table cells

Open

#2722 aperta il 4 dic 2025

Vedi su GitHub
 (3 commenti) (0 reazioni) (1 assegnatario)Python (4140 fork)batch import
buggood first issuemarkdown

Metriche repository

Star
 (59.751 star)
Metriche merge PR
 (Merge medio 7g 5h) (93 PR mergiate in 30 g)

Descrizione

Bug

In docling-core, the MarkdownTableSerializer transforms DoclingDocument headings and titles into markdown headings (i.e., text with preceding # symbols). According to the markdown specs, you can’t use headings, blockquotes, lists, horizontal rules, images, or most HTML tags when formatting text within tables and most applications will not render those headings properly.

Steps to reproduce

Convert Docling's test file table_with_heading_02.html to markdown or check its ground truth file table_with_heading_02.html.md

Docling version

Docling version: 2.64.0 Docling Core version: 2.51.1 Docling IBM Models version: 3.10.2 Docling Parse version: 4.7.1 Python: cpython-313 (3.13.5) Platform: macOS-14.7.1-arm64-arm-64bit-Mach-O

Python version

Python 3.13.5

Guida contributor

Direzione di ricerca
Esamina il MarkdownTableSerializer in docling core/transforms/serializer/markdown.py e modificalo per fare escape delle intestazioni (`#` iniziali) quando sono all'interno di una cella di tabella, seguendo la specifica markdown che vieta le intestazioni nelle tabelle.
Tech stack
python
Dominio
documentation
Tipo issue
Bug
DifficoltàQuanto dovrebbe essere impegnativa per un nuovo contributor.
2
Tempo stimatoTempo stimato per completare e verificare uno scope piccolo.
1-3 ore
Stato attivitàQuanto è probabile che la issue sia ancora attiva e reviewable.
Attiva
ChiarezzaQuanto chiaramente la issue descrive problema, scope e risultato atteso.
Chiara
Prerequisiti
Git
Adatta ai principiantiQuanto la issue è adatta a contributor alla prima esperienza.
65