# Markitdown Cli

> Use when converting local document files such as PDFs, Office documents, HTML, text, or other MarkItDown-supported inputs into Markdown.

- **Type:** Skill
- **Install:** `agentstack add skill-choral-io-choral-skills-markitdown-cli`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [choral-io](https://agentstack.voostack.com/s/choral-io)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [choral-io](https://github.com/choral-io)
- **Source:** https://github.com/choral-io/choral-skills/tree/main/skills/markitdown-cli
- **Website:** https://github.com/choral-io/choral-skills

## Install

```sh
agentstack add skill-choral-io-choral-skills-markitdown-cli
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# MarkItDown CLI

Use the installed `markitdown` command to convert readable local files into Markdown. Preserve source files and prefer the CLI over custom extraction code unless the user rejects it or a conversion fails for a clear reason.

Use for single-file or batch conversion, conversion checks or retries, stdin, and extensionless inputs. Do not use for summarizing without conversion, editing existing Markdown, dependency management, or standalone OCR/cloud extraction.

## Workflow

1. Locate inputs; inspect names, sizes, and planned output paths.
2. Verify `command -v markitdown`. If missing, report it, do not install without approval, and point to `https://github.com/microsoft/markitdown#installation`.
3. Choose output paths. Do not overwrite existing `.md` files unless replacement is explicit.
4. Run one `markitdown` invocation per input so failures are attributable. Quote paths and avoid unsafe glob assumptions.
5. Use `--extension` or `--mime-type` for stdin, extensionless files, or misleading filenames.
6. Spot-check Markdown for empty output, truncation, encoding problems, or missing structure.
7. Report converted files, skipped existing outputs, failures with exact CLI errors, and any follow-up dependency issue.

## Commands

| Need                  | Pattern                                                      |
| --------------------- | ------------------------------------------------------------ |
| Save converted output | `markitdown input.docx -o output.md`                         |
| Stream to stdout      | `markitdown input.pdf`                                       |
| Extensionless input   | `markitdown --extension pdf input -o output.md`              |
| Stdin type hint       | `markitdown --mime-type text/html -o output.md < input.html` |
| Text encoding         | `markitdown input.txt --charset utf-8 -o output.md`          |

Use `--use-docintel` or `--use-content-understanding` only for MarkItDown Markdown conversion when the user explicitly asks for that route and the required endpoint is configured.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [choral-io](https://github.com/choral-io)
- **Source:** [choral-io/choral-skills](https://github.com/choral-io/choral-skills)
- **License:** MIT
- **Homepage:** https://github.com/choral-io/choral-skills

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-choral-io-choral-skills-markitdown-cli
- Seller: https://agentstack.voostack.com/s/choral-io
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.