docling-project/docling

Markdown serialization of headings in rich table cells

Open

#2 722 ouverte le 4 déc. 2025

Voir sur GitHub
 (3 commentaires) (0 réactions) (1 assigné)Python (4 140 forks)batch import
buggood first issuemarkdown

Métriques du dépôt

Stars
 (59 751 stars)
Métriques de merge PR
 (Merge moyen 7j 5h) (93 PRs mergées en 30 j)

Description

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

Guide contributeur

Direction de recherche
Examinez le MarkdownTableSerializer dans docling core/transforms/serializer/markdown.py et modifiez le pour échapper les titres (`#` en tête) lorsqu'ils sont dans une cellule de tableau, conformément à la spécification markdown qui interdit les titres dans les tableaux.
Stack technique
python
Domaine
documentation
Type d'issue
Bug
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
2
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
1-3 heures
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
Active
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
Claire
Prérequis
Git
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
65