microsoft / microsoft/markitdown
Academic PDF conversion outputs non-standard Markdown with broken formatting
Open
Nobody has claimed this yet.
- Dominant language
- Python
- Stars
- 186k
- Forks
- 13.7k
- Avg merge
- 1d 4h
- Merged PRs (30d)
- 49
Description
Problem Description
When converting ACS journal academic PDF files using markitdown, the output Markdown file does not conform to standard Markdown syntax at all, and the structured parsing is completely invalid.
Reproduction Steps
- Install the latest version:
pip install markitdown - Run the official standard conversion code:
from markitdown import MarkItDown md = MarkItDown() result = md.convert("your_academic_paper.pdf") print(result.text)
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
Reproduce the issue with the documented MarkItDown conversion code and the attached ACS PDF, then inspect the generated Markdown alongside the reported conversation.md. The work is complete when the conversion produces valid, correctly structured Markdown for this academic PDF and the formatting problems are no longer present.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- python
- Domain
- tooling
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Needs clarification
- Newbie friendliness
- 45/100