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

19 beginner-friendly issues open

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
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
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
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
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
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
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
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
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]: fix, 解决markitdown-ocr因bbox的top值导致解析pdf文件图片识别的问题 Open

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

microsoft/markitdown#2097 · Opened Jun 9, 2026
Unrecognized Arguments Error in markitdown CLI for undocumented arguments Open

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

microsoft/markitdown#1897 · 1 comment · Opened May 20, 2026
markitdown-ocr process non-text layer PDFs generate an MD document containing only page numbers Open

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

microsoft/markitdown#1863 · 5 reactions · Opened May 6, 2026
UnicodeEncodeError Open

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

microsoft/markitdown#1788 · Opened Apr 17, 2026
fix packages/markitdown/src/markitdown/_uri_utils.py Open

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

microsoft/markitdown#1738 · 1 comment · Opened Apr 13, 2026
Add a shortcut for markitdown Open

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

microsoft/markitdown#1681 · 2 comments · Opened Apr 9, 2026
Make ZipConverter safety limits configurable via constructor parameters Open

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

microsoft/markitdown#1661 · Opened Apr 4, 2026
markitdown-mcp: Enhance tool to improve AI agent discoverability for file conversion tasks Open

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

microsoft/markitdown#1424 · 1 comment · Opened Sep 18, 2025
please provide the guide for install on the windows Open

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

microsoft/markitdown#1289 · 1 reaction · Opened Jun 12, 2025

microsoft/markitdown

Get new issues in your inbox