microsoft / microsoft/markitdown
Nested list in docx is not properly parsed in Markdown
Open
Nobody has claimed this yet.
- Dominant language
- Python
- Stars
- 186k
- Forks
- 13.7k
- Avg merge
- 1d 4h
- Merged PRs (30d)
- 49
Description
Description
When a word document contains nested lists like
1. Item 1
2. Item 2
• Item 2.1
• Item 2.2
3. Item 3
a) Item 3.1
b) Item 3.2
The output markdown will be wrongly rendered without the nested numbered list as:
1. Item 1
2. Item 2
* Item 2.1
* Item 2.2
3. Item 3
4. Item 3.1
5. Item 3.2
Reproduce
Original docx file to reproduce the bug: MarkItDown_MultiListBug_test.docx
Markdown output: output.md
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by converting the attached MarkItDown_MultiListBug_test.docx and compare the result with output.md. Trace the DOCX list parsing path to see where nested numbered items become top-level items. Done means the nested lists render at their original levels and the reproduced case is covered by a regression test.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- python
- Domain
- tooling
- Issue type
- Bug
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 68/100