Star200+

Markitdown

REVIEW · 74
Community indexed

Python tool for converting files and office documents to Markdown.

Verified installs1
Stars156.1K
Version1.0.0
Quality100/100 · Excellent
Trust74/100 · Sandbox only
Audit93/100 · Needs review

Supply asset profile

Research and knowledge work

Deep research, source comparison, literature review, RAG, knowledge search, and reports.

Browse track

Scenario

Document processing

I need my agent to read PDFs, extract tables, and turn documents into structured data.

Agent fit

Claude Code + OpenAI Agents + LangChain

Codex, Claude Code, Cursor, CLI, or custom agents.

Install

Ready

npx skills add microsoft/markitdown

Maintenance

active

3mo since push

Risk

Needs review

Financial research output is not financial advice; require human review before any live investment decision

GitHub quality

156K

100/100 Quality · 91/100 Trust

Coverage tags

ResearchDocument processingdocument-processingpdfdocuments

Review notes

Financial research output is not financial advice; require human review before any live investment decision · Financial research output is not financial advice; require human review before any live investment decision.

Agent adoption scorecard

Trust, audit, and install readiness at a glance

These scores combine public repository metadata, OpenAgentSkill review signals, maintenance freshness, and install readiness. They are a shortlist signal, not a replacement for human review.

Quality

Excellent
100

High-confidence pick with strong adoption and healthy maintenance signals.

Trust

Sandbox only
74

Useful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.

Audit

Needs review
93

A machine-readable review of install readiness, security metadata, maintenance, and adoption risk.

OpenAgentSkill Trust Score v5

Human review before install

Run only in a sandbox and compare close alternatives before using it for real work.

PythonPDFCodexClaude CodeCursor

Stars

156K GitHub stars

Repo activity

156K stars, 11K forks

Maintenance

3mo since push

License

MIT

Install

npx skills add microsoft/markitdown

Install safety

standard package or runtime install path

Permission surface

filesystem or document access

Agent outcomes

Early agent signal: 100% success from 1 agent outcomes

Docs

Usable metadata, review docs

Risk summary

Review before production

  • Financial research output is not financial advice; require human review before any live investment decision.
  • Agent Proven outcomes: Early agent signal: 100% success from 1 agent outcomes

Install readiness

Install path available

  • Install path is available
  • Repository evidence is available
  • License is declared
  • Early agent signal (42/100 Agent Proven)

Agent-readable metadata

Machine-readable decision data for this skill.

Use this block or the embedded JSON to decide whether an agent should install this skill, choose an alternative, or ask for human review first.

Open JSON

Suited tasks

  • Document processing workflows
  • Claude Code teams
  • teams that value GitHub adoption signals
  • Read uploaded files

Suited agents

PythonPDFCodexClaude CodeCursorOpenAgentSkill CLIOpenAI AgentsLangChain

Install decision

Command
npx skills add microsoft/markitdown
Policy
review
Human review
yes

Trust and risk

Trust
74/100
Audit
93/100
Risk level
Needs review

Outcome loop

Endpoint
/api/agent/outcome
Event ID
resolve
Outcomes
5

Install command

npx skills add microsoft/markitdown
Public auditEval reportResolve APIInstall handoff

Do not use when

  • teams that need a vendor-supported SLA
  • high-compliance environments without internal security review
  • No major risk signals from current metadata
  • Financial research output is not financial advice; require human review before any live investment decision
  • Financial research output is not financial advice; require human review before any live investment decision.

Alternative

PaddleOCR

83.1K Stars

npx skills add PaddlePaddle/PaddleOCR

Alternative

Stirling PDF

81.2K Stars

npx skills add Stirling-Tools/Stirling-PDF

Alternative

Tesseract

74.7K Stars

npx skills add tesseract-ocr/tesseract

Alternative

AFFiNE

69.4K Stars

npx skills add toeverything/AFFiNE

Agent safety v2

77/100 · Review before install

Reviewed with permission notesreview

Usable candidate, but the agent should surface permission and audit notes before installation.

Require human approval before installing into a real workspace.

Resolve via API

medium

Network access

Skill likely fetches remote pages, APIs, repositories, or external services.

medium

Filesystem access

Skill may read or write project files, documents, generated artifacts, or local workspace state.

  • Financial research output is not financial advice; require human review before any live investment decision

Install targets

Install this skill in your agent workflow

Use the public install endpoint to fetch the command, safety checklist, target prompts, and canonical links for this skill.

skill install

OpenAgentSkill CLI

Resolve policy, run the source installer safely, and report a verified install receipt.

$ npx --yes https://github.com/Leon-Drq/openagentskill/releases/download/cli-v0.2.1/openagentskill-0.2.1.tgz install microsoft-markitdown

Agent resolve plan

Let an agent verify fit before installing.

The Resolve API returns the selected skill, alternatives, safety policy, audit notes, install target, and copy-paste prompt an agent can follow without scraping this page.

Open text plan

Open JSON

/api/agent/resolve?task=Use%20Markitdown%20for%20an%20agent%20workflow&agent=codex&max_risk=medium

Resolve text

/api/agent/resolve?task=Use%20Markitdown%20for%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text

Install handoff

/api/skills/microsoft-markitdown/install

Agent should check

  • Task fit and alternatives from Resolve API.
  • Audit score, trust score, and safety policy warnings.
  • Install target compatibility for Codex, Claude Code, Cursor, or CLI.

Copy prompt

Task: Use Markitdown in this workspace.
Resolve first: https://www.openagentskill.com/api/agent/resolve?task=Use%20Markitdown%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Review install handoff: https://www.openagentskill.com/api/skills/microsoft-markitdown/install
Install command: npx skills add microsoft/markitdown
Before running it, summarize audit warnings, required permissions, and the fallback skill if install is risky.

Agent handoff

Give an agent the install path, not another directory page.

Use the public install endpoint to fetch the command, safety checklist, target prompts, and canonical links for this skill.

Open install API

Install handoff

/api/skills/microsoft-markitdown/install

LLM text format

/api/skills/microsoft-markitdown/install?format=text

Find alternatives

/api/skills/search?q=Markitdown&limit=3

Agent prompt

Use Markitdown for this task. Review https://www.openagentskill.com/api/skills/microsoft-markitdown/install, then install with: npx skills add microsoft/markitdown

Registry metadata

Agent-readable profile for automatic skill selection.

This page exposes the same decision, trust, audit, use-case, and install signals through the Registry API, so agents can rank this skill without scraping the UI.

Open manifest

Manifest

/api/registry/manifest/microsoft-markitdown

LLM text

/api/registry/manifest/microsoft-markitdown?format=text

Install alias

/api/registry/install/microsoft-markitdown

Recommend

/api/registry/recommend?task=Use%20Markitdown%20in%20an%20agent%20workflow&limit=3

Agent fit

100/100

Document processing

Use-case tags

Document processingRAG and knowledgeWorkflow automation

Platforms

Python, PDF, Claude Code, OpenAI Agents, LangChain

Audit report

Needs review · 93/100

A machine-readable review of install readiness, security metadata, maintenance, and adoption risk.

View audit reportView eval report

Agent decision cockpit

Primary pick for Document processing

Use this as a leading candidate, then validate the README and install path in your own agent stack.

100
Readiness
Adopt
Stage

Role in stack

Primary pick

Primary fit

Document processing

Trust label

Production-ready

Install path

Command ready

Use when

  • Document processing workflows
  • Claude Code teams
  • teams that value GitHub adoption signals

Evidence

  • 156,110 GitHub stars
  • recent repository activity
  • install command or GitHub repo available
  • 100/100 quality profile
  • 1498 OpenAgentSkill engagement events

review first

  • No major risk signals from current metadata

Implementation path

  1. 1Install it in a sandbox agent and run one Document processing task end to end.
  2. 2Compare output quality, latency, and failure behavior against at least one alternative.
  3. 3Promote it into production only after reviewing repository permissions, license, and maintenance signals.

Trust profile

Sandbox only

Useful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.

74
OpenAgentSkill Trust Score

GitHub adoption

PASS

156K GitHub stars

Stars/forks activity

PASS

156K stars, 11K forks; issue activity unavailable in current metadata

Recent maintenance

PASS

3mo since push

License clarity

PASS

MIT

Good signals

  • Manually verified listing
  • AI review approved
  • Install path is available
  • Repository evidence is available
  • Recently maintained repository
  • Large GitHub adoption signal
  • Install command has no obvious high-risk pattern
  • OpenAgentSkill usage activity detected
  • Outcome confidence 25% from 1 report(s)

Review before install

  • Financial research output is not financial advice; require human review before any live investment decision.
  • Agent Proven outcomes: Early agent signal: 100% success from 1 agent outcomes
  • Human review required before unattended installation

Recommended action

Run only in a sandbox and compare close alternatives before using it for real work.

Quality profile

Excellent candidate for agent workflows

High-confidence pick with strong adoption and healthy maintenance signals.

100
GitHub stars
156K
Freshness
3mo ago
Install ready
Yes
License
MIT

Workflow fit

Use this skill in these scenarios

Parse messy files

Document processing

I need my agent to read PDFs, extract tables, and turn documents into structured data.

Search private knowledge

RAG and knowledge

I need my agent to build a RAG workflow over documents and retrieve reliable context.

Automate repeated work

Workflow automation

I need my agent to automate a repeated workflow across tools and files.

Workflow fit

Add it to a complete workflow

Ingest, retrieve, and cite

RAG knowledge base

A workflow for document-heavy agents that ingest files, create searchable knowledge, retrieve relevant context, and answer with grounded sources.

Turn skills into distribution

Content growth agent

A workflow for turning newly indexed skills into SEO briefs, social drafts, comparison pages, and reusable publishing workflows.

Scrape, clean, and reuse web data

Web data pipeline

A practical workflow for agents that crawl public pages, extract clean content, normalize data, and hand it to downstream research or RAG workflows.

Alternative shortlist

Compare before you install

Similar skills that may fit this task.

Compare all

PaddleOCR

Turn any PDF or image document into structured data for your AI. A powerful, lightweight OCR toolkit that bridges the gap between images/PDFs and LLMs. Supports 100+ languages.

Adopt
Ready100
Quality100
Stars83.1K

Stirling PDF

#1 PDF Application on GitHub that lets you edit PDFs on any device anywhere

Adopt
Ready100
Quality100
Stars81.2K

Tesseract

Tesseract Open Source OCR Engine (main repository)

Adopt
Ready100
Quality100
Stars74.7K

AFFiNE

There can be more than Notion and Miro. AFFiNE(pronounced [ə‘fain]) is a next-gen knowledge base that brings planning, sorting and creating all together. Privacy first, open-source, customizable and ready to use.

Adopt
Ready100
Quality100
Stars69.4K

Overview

Python tool for converting files and office documents to Markdown.

Imported by the skill-only GitHub discovery pipeline because it matches agent skill, automation, domain workflow, RAG, document-processing, data, finance, security, or developer-tool signals. Protocol-server projects are excluded from automated imports.

Platform compatibility

pythonFULL
pdfFULL

Technical details

Version
1.0.0
License
MIT
Last updated
Aug 18, 2026
Published
May 21, 2026

Frameworks & tools

PythonPDF

Decision snapshot

Primary pick

100
Ready
Adopt
Stage

156,110 GitHub stars

Audit

Install review

Install and adoption review

93
Needs review
Security
88/100
Maintenance
88/100
Install
92/100
Open full auditView eval report

Agent-proven evidence

Agent-proven evidence

Outcome reports after resolve, review, install, and one narrow run.

42
Proven
Early agent signalAuto-install: review firstLast: Aug 10, 2026
Success rate
100%
Recent failure
0%
Outcomes
1
Output quality
—
Failed
0
Not relevant
0
Installs
1
Risk blocked
0
Setup needed
0
Production
0

Early agent signal: 1 outcome, 100% success, Agent Proven Score 42/100.

Agent-Proven rankingOutcome contract

Install

Add to agent workflow

Free and open source. Review the report before installing into production agents.

Compare AlternativesAuto-resolve PlanView on GitHubDocumentation

Growth loop

Share kit

X

Scenario-led draft for Markitdown, ready for a manual X post.

Curator note
Before you hand an agent source-backed research, give it a repeatable starting point.

Markitdown: Python tool for converting files and office documents to Markdown.

156.1K stars

https://www.openagentskill.com/skills/microsoft-markitdown?ref=x
Open X draft
Optional reply with install command
Listing + install path for Markitdown:
https://www.openagentskill.com/skills/microsoft-markitdown?ref=x

Install: npx skills add microsoft/markitdown
Open reply draft

Listing source

Community indexed

Claimable

This listing was indexed from public sources and is not marked official until a maintainer claim is approved.

Creator
microsoft
Indexed by
OpenAgentSkill community index

Attribution links to the public repository or creator profile. Creators can claim the listing to update ownership signals.

Claim this skill

Owner claim

Claim this skill listing

This Community indexed listing is attributed to microsoft but is not marked official yet. Claim it to add a verified owner signal and make future launch, install, and audit updates easier to trust.

Creator backlink kit

Add the evidence badges to your README

Show the canonical listing, current trust and audit signals, and real Agent-Proven evidence where developers evaluate the repository.

[![Listed on OpenAgentSkill](https://www.openagentskill.com/api/badge/microsoft-markitdown?metric=listed&label=Listed)](https://www.openagentskill.com/skills/microsoft-markitdown)
[![OpenAgentSkill Trust](https://www.openagentskill.com/api/badge/microsoft-markitdown?metric=trust&label=Trust)](https://www.openagentskill.com/skills/microsoft-markitdown)
[![OpenAgentSkill Audit](https://www.openagentskill.com/api/badge/microsoft-markitdown?metric=audit&label=Audit)](https://www.openagentskill.com/skills/microsoft-markitdown/audit)
[![Agent Proven](https://www.openagentskill.com/api/badge/microsoft-markitdown?metric=proven&label=Agent%20Proven)](https://www.openagentskill.com/skills/microsoft-markitdown)
Preview badge Open audit Creator kit

Author

M

microsoft✓

@microsoft

Tags

pdfdocumentsextractionautogenautogen-extensionlangchainmarkdownmicrosoft-officeopenaipython

Platform fit

Claude CodeOpenAI AgentsLangChain

Health signals

GitHub stars
156.1K
Quality score
80/100
Last GitHub push
May 26, 2026
Framework hints
2
OpenAgentSkill views
97
Install copies
9
Outbound clicks
2

Community signal

Share whether this skill looks useful for your agent workflow. Aggregated feedback improves rankings over time.

Trust & safety

Sandbox only

74
  • GitHub adoption156K GitHub starsPASS
  • Stars/forks activity156K stars, 11K forks; issue activity unavailable in current metadataPASS
  • Recent maintenance3mo since pushPASS
  • License clarityMITPASS
  • README/SKILL.md completenessPublic metadata needs stronger README/SKILL.md contextINFO
  • Dependency/runtime riskno major dependency risk hints in public metadataPASS

Related skills

PaddleOCR

Turn any PDF or image document into structured data for your AI. A powerful, lightweight OCR toolkit that bridges the gap between images/PDFs and LLMs. Supports 100+ languages.

83.1K Stars

Stirling PDF

#1 PDF Application on GitHub that lets you edit PDFs on any device anywhere

81.2K Stars

Tesseract

Tesseract Open Source OCR Engine (main repository)

74.7K Stars

AFFiNE

There can be more than Notion and Miro. AFFiNE(pronounced [ə‘fain]) is a next-gen knowledge base that brings planning, sorting and creating all together. Privacy first, open-source, customizable and ready to use.

69.4K Stars
InstallView on GitHub