microsoft/markitdown

View on GitHub

Python tool for converting files and office documents to Markdown.

Stars: 186k
Forks: 13.7k
Open beginner issues: 0
Indexed issues: 328
Avg merge: 1d 4h
Merged PRs (30d): 49

Dominant language: Python
License: MIT
Last GitHub push: Sep 16, 2026
Latest indexed: Sep 19, 2026
Contributing guide: No contributing guide
Code of conduct: Code of conduct
Beginner labels: good first issue

Beginner friendly Everything

Open All

328 open issues indexed

HTML tables lose the header delimiter row after `<caption>` or `<colgroup>`, and `<tfoot>` adds a fake header Open

Difficulty 3/5 1-2 days Newbie friendliness 74/100

microsoft/markitdown#2536 · Opened Sep 18, 2026
XLSX/XLS: float values rendered in 6-digit scientific notation, entered digits are dropped Open

Difficulty 3/5 1-2 days Newbie friendliness 68/100

microsoft/markitdown#2532 · Opened Sep 18, 2026
DOCX: Heading 7-9 styles lose heading structure entirely (render as plain paragraphs) Open

Difficulty 2/5 1-3 hours Newbie friendliness 75/100

microsoft/markitdown#2530 · Opened Sep 18, 2026
fenced code blocks lose blank-line runs and trailing spaces during conversion Open

Difficulty 3/5 1-2 days Newbie friendliness 68/100

microsoft/markitdown#2528 · Opened Sep 18, 2026
pptx: missing chart data points render as the literal string "None" Open

Difficulty 3/5 1-2 days Newbie friendliness 72/100

microsoft/markitdown#2526 · Opened Sep 18, 2026
PPTX chart conversion drops parent category labels Open

Difficulty 2/5 1-3 hours Newbie friendliness 88/100

microsoft/markitdown#2502 · Opened Sep 15, 2026
HTML conversion loses the base URL for relative links and images Open

Difficulty 3/5 1-2 days Newbie friendliness 76/100

microsoft/markitdown#2500 · Opened Sep 15, 2026
Excel conversion replaces literal NA/NULL strings and blank cells with NaN Open

Difficulty 3/5 1-2 days Newbie friendliness 78/100

microsoft/markitdown#2498 · Opened Sep 15, 2026
XLSX/XLS: whole numbers render as "1.0" when the column contains a blank cell Open

Difficulty 3/5 1-2 days Newbie friendliness 72/100

microsoft/markitdown#2484 · 1 comment · Opened Sep 13, 2026
HTML: <title> leaks into markdown body for documents without <body>; stray content outside <body> dropped Open

Difficulty 3/5 1-2 days Newbie friendliness 72/100

microsoft/markitdown#2482 · 1 comment · Opened Sep 13, 2026
Base64 data URIs fail or decode incorrect bytes when their payload is percent-encoded Open

Difficulty 2/5 1-3 hours Newbie friendliness 84/100

microsoft/markitdown#2481 · Opened Sep 13, 2026
Bug: Extensionless log streams can be rendered as CSV tables Open

Difficulty 3/5 1-2 days Newbie friendliness 72/100

microsoft/markitdown#2474 · 3 comments · Opened Sep 12, 2026
XLSX/XLS: a completely empty sheet emits malformed table syntax under its heading Open

Difficulty 2/5 1-3 hours Newbie friendliness 76/100

microsoft/markitdown#2470 · 2 comments · Opened Sep 12, 2026
RSS/Atom: urljoin collapses significant repeated slashes in resolved links Open

Difficulty 5/5 Over a week Newbie friendliness 35/100

microsoft/markitdown#2468 · Opened Sep 11, 2026
markitdown-mcp: mandatory markitdown[all] breaks native Windows ARM64 installation Open

Difficulty 3/5 1-2 days Newbie friendliness 72/100

microsoft/markitdown#2440 · 4 comments · Opened Sep 10, 2026
HTML/DOCX: pipe characters in table cells break Markdown tables Open

Difficulty 2/5 1-3 hours Newbie friendliness 78/100

microsoft/markitdown#2438 · Opened Sep 10, 2026
XLSX/XLS: pipe characters in cells break Markdown tables Open

Difficulty 3/5 1-2 days Newbie friendliness 72/100

microsoft/markitdown#2436 · Opened Sep 10, 2026
OCR XLSX converter still fails on legacy showZeroes sheet views Open

Difficulty 3/5 1-2 days Newbie friendliness 78/100

microsoft/markitdown#2400 · Opened Sep 7, 2026
OCR PPTX converter crashes on SVG images without a raster fallback Open

Difficulty 3/5 1-2 days Newbie friendliness 78/100

microsoft/markitdown#2399 · Opened Sep 7, 2026
OCR PPTX converter still crashes when shape or notes text is None Open

Difficulty 2/5 1-3 hours Newbie friendliness 82/100

microsoft/markitdown#2398 · Opened Sep 7, 2026
Autonomous Agents, Unite! Open

good first issue

Difficulty 5/5 Over a week Newbie friendliness 20/100

microsoft/markitdown#2386 · 4 comments · Opened Sep 4, 2026
markitdown-ocr: placeholder prefix collision drops OCR blocks in DOCX with 11 or more images Open

Difficulty 2/5 1-3 hours Newbie friendliness 88/100

microsoft/markitdown#2383 · 1 comment · Opened Sep 4, 2026
markitdown-ocr: OCR text is matched to DOCX images by position instead of identity Open

Difficulty 3/5 1-2 days Newbie friendliness 78/100

microsoft/markitdown#2382 · 1 comment · Opened Sep 4, 2026
PDF: paragraph breaks inserted inside sentences (prose corrupted at arbitrary line gaps) Open

Difficulty 3/5 1-2 days Newbie friendliness 55/100

microsoft/markitdown#2370 · 1 comment · Opened Sep 2, 2026
markitdown-ocr: three PDF bugs — scanned pages never OCR'd, per-page PDF reopen, page-level scan misdetection Open

Difficulty 3/5 1-2 days Newbie friendliness 72/100

microsoft/markitdown#2343 · Opened Aug 26, 2026
Improve Arabic/RTL PDF text extraction: logical reading order and table column associations are not preserved Open

Difficulty 5/5 Over a week Newbie friendliness 42/100

microsoft/markitdown#2336 · 3 comments · 2 reactions · Opened Aug 24, 2026
Security: delete the Content Understanding result after reading it (needed for multi-session hosted agents) Open

Difficulty 3/5 1-2 days Newbie friendliness 68/100

microsoft/markitdown#2327 · Opened Aug 21, 2026
Nested list in docx is not properly parsed in Markdown Open

Difficulty 3/5 1-2 days Newbie friendliness 68/100

microsoft/markitdown#2323 · Opened Aug 21, 2026
Better exception handling/warning in LLMVisionOCRService.extract_text Open

Difficulty 3/5 1-2 days Newbie friendliness 62/100

microsoft/markitdown#2313 · 2 comments · 1 reaction · Opened Aug 18, 2026
Proposal: clarify the supported Docker workflow before further deployment changes Open

Difficulty 5/5 Over a week Newbie friendliness 30/100

microsoft/markitdown#2306 · Opened Aug 15, 2026
processes the selected sheet when .xlsx Open

Difficulty 3/5 1-2 days Newbie friendliness 68/100

microsoft/markitdown#2290 · 1 comment · Opened Aug 11, 2026
MarkItDown 解析旧版 .doc 存在原生崩溃 Bug Open

Difficulty 3/5 1-2 days Newbie friendliness 45/100

microsoft/markitdown#2288 · Opened Aug 10, 2026
Error while pip install -e 'packages/markitdown[all]' Open

Difficulty 2/5 1-3 hours Newbie friendliness 58/100

microsoft/markitdown#2287 · 1 comment · 1 reaction · Opened Aug 10, 2026
Feature request: Possibility to include comments of docx into md file Open

Difficulty 4/5 3-5 days Newbie friendliness 50/100

microsoft/markitdown#2275 · Opened Aug 5, 2026
Title: Expose model_id and analysis features as configurable parameters in DocumentIntelligenceConverter Open

Difficulty 3/5 1-2 days Newbie friendliness 72/100

microsoft/markitdown#2273 · 8 reactions · Opened Aug 4, 2026
Add reader mode for automatic article content extraction from web pages Open

Difficulty 5/5 Over a week Newbie friendliness 48/100

microsoft/markitdown#2234 · 2 comments · Opened Jul 23, 2026
Poor Markdown conversion quality for academic paper Open

Difficulty 4/5 3-5 days Newbie friendliness 38/100

microsoft/markitdown#2226 · 2 comments · 1 reaction · Opened Jul 20, 2026
markitdown outputs plain text instead of Markdown when converting PDF Open

Difficulty 4/5 3-5 days Newbie friendliness 45/100

microsoft/markitdown#2214 · 1 comment · Opened Jul 15, 2026
Add \markitdown --info FILE\ flag to emit document metadata as JSON (no full conversion) Open

Difficulty 5/5 Over a week Newbie friendliness 42/100

microsoft/markitdown#2182 · 1 comment · Opened Jul 1, 2026
converting docx files to markdown with markitdown.exe does not escape special characters Open

Difficulty 3/5 1-2 days Newbie friendliness 48/100

microsoft/markitdown#2157 · 1 comment · Opened Jun 24, 2026
Regarding the issue where images cannot be converted when converting DOCX to MD documents during tool usage Open

Difficulty 4/5 3-5 days Newbie friendliness 42/100

microsoft/markitdown#2155 · Opened Jun 23, 2026
markitdown-mcp: server process dies on invalid_id / oversized input (Claude Code + Cursor) Open

Difficulty 4/5 3-5 days Newbie friendliness 35/100

microsoft/markitdown#2146 · Opened Jun 19, 2026
Missing claude desktop config for Non-docker (pip) install method Open

Difficulty 2/5 1-3 hours Newbie friendliness 62/100

microsoft/markitdown#2128 · Opened Jun 15, 2026
DOCX: internal TOC / cross-reference hyperlinks emit dead [text](#_Toc…) anchors Open

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

microsoft/markitdown#2125 · 2 comments · Opened Jun 15, 2026
XLSX: first data row used as header → "Unnamed: N" columns + "NaN" cells; empty rows/cols not pruned Open

Difficulty 3/5 1-2 days Newbie friendliness 48/100

microsoft/markitdown#2124 · 1 comment · Opened Jun 15, 2026
Proposal: Add a community showcase or related projects section Open

Difficulty 2/5 1-3 hours Newbie friendliness 58/100

microsoft/markitdown#2123 · 4 comments · 1 reaction · Opened Jun 15, 2026
bug: IpynbConverter loses document title when cell source is a string instead of list Open

Difficulty 2/5 1-3 hours Newbie friendliness 88/100

microsoft/markitdown#2115 · 1 comment · Opened Jun 12, 2026
bug: consecutive partial numbers (.1 followed by .2) wrongly merged into '.1 .2' Open

Difficulty 2/5 1-3 hours Newbie friendliness 35/100

microsoft/markitdown#2114 · Opened Jun 12, 2026
How to use it in Windows 11？ Open

Difficulty 1/5 Under an hour Newbie friendliness 55/100

microsoft/markitdown#2106 · 9 comments · Opened Jun 11, 2026
[BUG]: fix, 解决markitdown-ocr因bbox的top值导致解析pdf文件图片识别的问题 Open

Difficulty 2/5 1-3 hours Newbie friendliness 82/100

microsoft/markitdown#2097 · Opened Jun 9, 2026

microsoft/markitdown

Get new issues in your inbox