BrowseProductivity & docs tools
MarkItDown
Python utility and CLI that converts PDF, Office documents, images, audio, HTML and other files to Markdown for use with LLMs.
Tested on Linux
Use it
Linux x86_64
You need first
- Runtimes:
python>=3.10,<=3.14
create venv, pip install 'markitdown[all]', link markitdown into ~/.local/bin
python3 -m venv ~/.venv && ~/.venv/bin/pip install -q 'markitdown[all]' && ln -sf ~/.venv/bin/markitdown ~/.local/bin/markitdowninstall markitdown-sample-plugin for plugin check
~/.venv/bin/pip install -q markitdown-sample-plugin
Check that it works
markitdown --versionThe output should contain “markitdown 0.1.9”.
First thing to try
cat > page.html <<'EOF'
<html><body><h1>Main Heading</h1><h2>Sub</h2><ul><li>apple</li><li>banana</li></ul>
<p>See <a href="https://example.com/docs">the docs</a>.</p>
<table><tr><th>Col A</th><th>Col B</th></tr><tr><td>1</td><td>2</td></tr></table></body></html>
EOF
cat > gen.py <<'EOF'
from docx import Document
d = Document()
d.add_heading("Quarterly Report", level=1)
d.add_paragraph("First bullet item", style="List Bullet")
d.add_paragraph("Second bullet item", style="List Bullet")
t = d.add_table(rows=2, cols=2)
t.cell(0,0).text="Name"; t.cell(0,1).text="Value"
t.cell(1,0).text="Alpha"; t.cell(1,1).text="42"
d.save("sample.docx")
from openpyxl import Workbook
wb = Workbook(); ws = wb.active; ws.title="Sales"
ws.append(["Region","Units"]); ws.append(["North",120]); ws.append(["South",95])
wb.save("sample.xlsx")
from pptx import Presentation
p = Presentation(); s = p.slides.add_slide(p.slide_layouts[1])
s.shapes.title.text = "Slide Title Hello"; s.placeholders[1].text = "Bullet on slide"
p.save("sample.pptx")
objs = [b"<< /Type /Catalog /Pages 2 0 R >>",
b"<< /Type /Pages /Kids [3 0 R] /Count 1 >>",
b"<< /Type /Page /Parent 2 0 R /MediaBox [0 0 612 792] /Contents 4 0 R /Resources << /Font << /F1 5 0 R >> >> >>",
None,
b"<< /Type /Font /Subtype /Type1 /BaseFont /Helvetica >>"]
stream = b"BT /F1 24 Tf 72 700 Td (Hello PDF from MarkItDown) Tj ET"
objs[3] = b"<< /Length %d >>\nstream\n" % len(stream) + stream + b"\nendstream"
out = b"%PDF-1.4\n"; offs = []
for i,o in enumerate(objs):
offs.append(len(out)); out += b"%d 0 obj\n" % (i+1) + o + b"\nendobj\n"
x = len(out)
out += b"xref\n0 %d\n0000000000 65535 f \n" % (len(objs)+1)
for o in offs: out += b"%010d 00000 n \n" % o
out += b"trailer\n<< /Size %d /Root 1 0 R >>\nstartxref\n%d\n%%%%EOF\n" % (len(objs)+1, x)
open("path-to-file.pdf","wb").write(out)
EOF
~/.venv/bin/pip install -q python-docx && ~/.venv/bin/python gen.pymarkitdown path-to-file.pdf -o document.md && cat document.mdRun markitdown <file> to print a file's contents as Markdown.
What it does
- Convert PDF, Word, PowerPoint and Excel files to MarkdownTested
How to use it
- Run
markitdown <file>.pdf -o <output>.mdto save a PDF as a Markdown file. - Run
markitdown <file>.docx,markitdown <file>.xlsxormarkitdown <file>.pptxto print the Markdown to the terminal.
- Run
- Keep headings, lists, tables and links in the outputTested
How to use it
- Run
markitdown <file>.docxto get headings, lists and tables as Markdown. - Run
markitdown <file>.htmlto convert a web page, with links kept as Markdown links.
- Run
- Caption images and transcribe audioNot tested
- Add more file formats with third-party pluginsNot shown working
How far pickfit got
Linux x86_64
- Installs
- Starts
- 2 of 4 features work
- Works offline
Good for
- convert a PDF file to Markdown
- prepare documents as Markdown for LLM text analysis pipelines
- extract structured fields from invoices via Azure Content Understanding
An alternative to textract.
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 15 Nov 2026
- Version 0.1.9
Differences the test machine hit
- README: pip install 'markitdown[all]'
In the test: Installed into a venv (python3 -m venv ~/.venv) as the README's Prerequisites recommend, then symlinked ~/.venv/bin/markitdown into ~/.local/bin so it is on PATH - README: git clone git@github.com:microsoft/markitdown.git
In the test: Not needed; the SSH clone URL would also need a GitHub SSH key (https URL works without one) - README: markitdown path-to-file.pdf -o document.md
In the test: No sample files are shipped; inputs were generated (python-docx is not part of markitdown[all], installed only to create the test .docx)