Markitdown
Python tool for converting files and office documents to Markdown.
Supply asset profile
Research and knowledge work
Deep research, source comparison, literature review, RAG, knowledge search, and reports.
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
1mo since push
Risk
Safe to try
No major risk signals from available metadata
GitHub quality
156K
100/100 quality · 90/100 trust
Coverage tags
Review notes
No major risk signals from available metadata
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
ExcellentHigh-confidence pick with strong adoption and healthy maintenance signals.
Trust
Review then installGood shortlist signal, but the agent should review audit notes, install policy, and outcome evidence before running it.
Audit
Safe to tryInstall readiness, security metadata, maintenance, and adoption risk.
Trust Score v5
Agent install candidate
Use as the primary candidate after human or sandbox review.
Stars
156K GitHub stars
Repo activity
156K stars, 11K forks
Maintenance
1mo 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
No agent outcome data yet
Docs
Usable metadata, review docs
Risk summary
Low metadata risk
- No major trust warnings detected from available metadata
Install readiness
Install path available
- Install path is available
- Repository evidence is available
- License is declared
- No Agent Proven outcome evidence yet
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.
Suited tasks
- Document processing workflows
- Claude Code teams
- teams that value GitHub adoption signals
- Read uploaded files
Suited agents
Install decision
- Command
- npx skills add microsoft/markitdown
- Policy
- allow
- Human review
- no
Trust and risk
- Trust
- 87/100
- Audit
- 92/100
- Risk level
- Safe to try
Outcome loop
- Endpoint
- /api/agent/outcome
- Event ID
- resolve
- Outcomes
- 5
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
- No major trust warnings detected from available metadata
- Production credentials, payments, or irreversible account changes without explicit human review
Agent safety v2
84/100 · Safe to install with normal review
Strong metadata, audit, install, and review signals. Suitable for agent shortlists after normal workspace review.
Allow agent install in a sandbox or low-risk workspace, then promote after one successful narrow task.
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.
Install targets
Install this skill in your agent workflow
Copy the registry command or an agent-specific install prompt for Codex, Claude Code, and Cursor.
OpenAgentSkill CLI
Use the registry command when your workflow supports the OpenAgentSkill installer.
$ npx skills add microsoft/markitdownAgent 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.
Resolve 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.
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/markitdownRegistry 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.
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
Document processing
Platforms
Python, PDF, Claude Code, OpenAI Agents, LangChain
Audit report
Safe to try · 92/100
Review install readiness, maintenance, trust, quality, and metadata warnings before adding this skill to an agent workflow.
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.
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
- 712 OpenAgentSkill engagement events
Review first
- No major risk signals from current metadata
Implementation path
- 1Install it in a sandbox agent and run one Document processing task end to end.
- 2Compare output quality, latency, and failure behavior against at least one alternative.
- 3Promote it into production only after reviewing repository permissions, license, and maintenance signals.
Trust profile
Review then install
Good shortlist signal, but the agent should review audit notes, install policy, and outcome evidence before running it.
GitHub adoption
PASS156K GitHub stars
Stars/forks activity
PASS156K stars, 11K forks; issue activity unavailable in current metadata
Recent maintenance
PASS1mo since push
License clarity
PASSMIT
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 loop is ready but needs first real agent run
Review before install
- No real agent outcome reports yet
- Human review required before unattended installation
Recommended action
Use as the primary candidate after human or sandbox review.
Quality profile
Excellent candidate for agent workflows
High-confidence pick with strong adoption and healthy maintenance signals.
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.
Stack fit
Add it to a complete workflow
Ingest, retrieve, and cite
RAG knowledge base
A stack 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 stack 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 stack 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 in this category, ranked with the same readiness and quality signals.
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.
Stirling PDF
#1 PDF Application on GitHub that lets you edit PDFs on any device anywhere
Tesseract
Tesseract Open Source OCR Engine (main repository)
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.
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
Technical Details
- Version
- 1.0.0
- License
- MIT
- Last Updated
- 6/20/2026
- Published
- 5/21/2026
Frameworks & Tools
Decision snapshot
Primary pick
156,110 GitHub stars
Audit snapshot
Install review
Install and adoption review
- Security
- 88/100
- Maintenance
- 88/100
- Install
- 92/100
Agent-proven evidence
Agent Proven evidence
Outcome reports after resolve, review, install, and one narrow run.
- Success rate
- —
- Recent failure
- —
- Outcomes
- 0
- Output quality
- —
- Failed
- 0
- Not relevant
- 0
- Installs
- 0
- Risk blocked
- 0
- Setup needed
- 0
- Production
- 0
No agent outcome data yet. The first agent run can report success, setup needs, risk blocks, failure, or not-relevant through /api/agent/outcome.
Install
Add to agent workflow
Free and open source. Review the audit before production use.
Growth loop
Share kit
Scenario-led draft for Markitdown, ready for a manual X post.
The useful research skills are not search wrappers. They help agents keep sources attached. Markitdown helps agents turn docs, data, or knowledge bases into grounded work. 156.1K stars https://www.openagentskill.com/skills/microsoft-markitdown?ref=x #AIAgents
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
Listing source
Community indexed
This listing was indexed from public sources and is not marked official until a maintainer claim is approved.
- Creator
- microsoft
- Source
- microsoft/markitdown
- 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 skillOwner 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.
README badge
Add this badge to your GitHub README to show the listing, trust score, and install handoff.
[](https://www.openagentskill.com/skills/microsoft-markitdown)Author
microsoft✓
@microsoft
Platform Fit
Health Signals
- GitHub stars
- 156.1K
- Quality score
- 78/100
- Last GitHub push
- May 26, 2026
- Framework hints
- 2
- OpenAgentSkill views
- 28
- Install copies
- 7
- Outbound clicks
- 2
Community Signal
Share whether this skill looks useful for your agent workflow. Aggregated feedback improves rankings over time.
Trust & Safety
Review then install
- GitHub adoption156K GitHub starsPASS
- Stars/forks activity156K stars, 11K forks; issue activity unavailable in current metadataPASS
- Recent maintenance1mo 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 · 0 installsStirling PDF
#1 PDF Application on GitHub that lets you edit PDFs on any device anywhere
81.2K stars · 0 installsTesseract
Tesseract Open Source OCR Engine (main repository)
74.7K stars · 0 installsAFFiNE
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 · 0 installs