菜单
Convert various file formats (PDF, DOCX, XLSX, PPTX, HTML, images, etc.) to Markdown via CLI. Invoke when user needs to extract text from documents or convert files to Markdown format.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | markitdown |
| description | Convert various file formats (PDF, DOCX, XLSX, PPTX, HTML, images, etc.) to Markdown via CLI. Invoke when user needs to extract text from documents or convert files to Markdown format. |
Activate this skill when the user asks to:
markitdown must be installed and available in PATH.pip install 'markitdown[all]'For document conversion tasks, always use markitdown CLI.
pip install 'markitdown[all]'
markitdown <file_path_or_url>
markitdown document.pdf
markitdown presentation.pptx
markitdown spreadsheet.xlsx
markitdown document.docx
markitdown page.html
markitdown ebook.epub
markitdown email.msg
markitdown https://example.com/document.pdf
markitdown https://example.com/page.html
markitdown document.pdf > output.md
cat document.pdf | markitdown
curl -s https://example.com/doc.pdf | markitdown
| Format | Extension | Notes |
|---|---|---|
.pdf | Extracts text from PDF documents | |
| Word | .docx | Microsoft Word documents |
| Excel | .xlsx | Microsoft Excel spreadsheets |
| PowerPoint | .pptx | Microsoft PowerPoint presentations |
| HTML | .html, .htm | Web pages |
| Images | .png, .jpg, .jpeg, .gif, .bmp | Uses OCR if enabled |
| Text | .txt, .md, .csv, .json, .xml | Plain text formats |
| EPUB | .epub | E-book format |
| Outlook | .msg, .eml | Email messages |
ls -la document.pdf
markitdown document.pdf
markitdown data.xlsx
markitdown slides.pptx
markitdown https://example.com/article.html
for file in *.pdf; do
echo "=== $file ==="
markitdown "$file"
done
for file in *.pdf; do
markitdown "$file" > "${file%.pdf}.md"
done
For large documents, preview the first part:
markitdown large-document.pdf | head -100
markitdown document.pdf | wc -l
markitdown document.pdf | grep -i "keyword"
If you encounter SSL errors on macOS:
Install OpenSSL:
brew install openssl@3
Set the environment variable:
export SSL_CERT_FILE=/opt/homebrew/etc/openssl@3/cert.pem
markitdown https://example.com/document.pdf
Always verify the file exists before conversion:
if [ -f "document.pdf" ]; then
markitdown document.pdf
else
echo "File not found: document.pdf"
fi
For URLs requiring authentication, download first:
curl -H "Authorization: Bearer token" -o doc.pdf "https://api.example.com/doc.pdf"
markitdown doc.pdf
Large Files: Very large files may produce extensive output. Consider piping to head or saving to a file.
URLs with Special Characters: Quote URLs properly:
markitdown "https://example.com/doc with spaces.pdf"
Combine with Other Tools: Use pipes for powerful workflows:
markitdown document.pdf | grep -A5 "Chapter 1"
Check Installation: Verify markitdown is installed:
which markitdown && markitdown --help
pip install 'markitdown[all]'SSL_CERT_FILE environment variable (macOS)ls -la <file>Spec-driven development workflow. ACTIVATE THIS SKILL broadly — whenever the user's message contains keywords like 'requirements', 'plan', 'spec', 'design', 'tasks', 'feature', 'build', 'implement', 'architecture', '需求', '计划', '设计', '任务', '功能', '实现', or any topic that may benefit from structured development. Err on the side of activating. After activation, the skill itself will analyze intent and decide the appropriate action.
Create or update a skill in this repository under skills/<skill-name>. Use when the user asks to add a new skill, improve an existing skill, scaffold skill structure, or align a skill with repository standards.
Work with Obsidian vaults — create and edit Obsidian Flavored Markdown (.md), Bases (.base), JSON Canvas (.canvas), and interact with vaults via the Obsidian CLI. Use when working with Obsidian notes, wikilinks, callouts, embeds, properties, frontmatter, tags, bases, canvas files, or vault operations.
Build and modify Grafana dashboards following the user's established style conventions. Use when creating new dashboards, adding panels, modifying existing dashboards, or reviewing dashboard JSON for consistency. Requires the Grafana MCP to be enabled.
Operate GitLab from terminal with `glab` for repositories, merge requests, issues, pipelines, releases, and API calls. Use for any GitLab task. For template-compliant MR creation, load reference workflow under references/.
Operate GitHub from terminal with `gh` for repositories, pull requests, issues, releases, actions, and API calls. Use for any GitHub task. For template-compliant PR or issue creation, load reference workflows under references/.