Community写作与编辑github.com

steipete/markdown-converter

将文件转换为 Markdown 格式:支持 PDF、Office 文档、HTML、数据文件、OCR、音频、ZIP 和 YouTube 链接。

markdown-converter 是什么?

Markdown Converter 是一款基于 `uvx markitdown` 的工具,用于将多种文件格式快速转换为 Markdown。它无需安装任何依赖,可直接在命令行运行。支持 Windows、macOS 和 Linux 平台,适用于需要批量处理文档(PDF、Word、Excel、PowerPoint)、网页数据(HTML、CSV、JSON)、媒体文件(图片 OCR、音频转录)和压缩包(ZIP)的场景。工具通过 `uvx` 即时调用,首次运行会缓存依赖,后续使用更快。对于复杂 PDF,可配合 Azure Document Intelligence 提升提取质量。用户只需一条命令即可获得结构完整的 Markdown 输出。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/markdown-converter

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Markdown Converter

将文件转换为 Markdown 格式,使用 uvx markitdown — 无需安装。

基本用法

# 输出到标准输出
uvx markitdown input.pdf

# 保存到文件
uvx markitdown input.pdf -o output.md
uvx markitdown input.docx > output.md

# 从标准输入读取
cat input.pdf | uvx markitdown

支持的格式

  • 文档:PDF、Word (.docx)、PowerPoint (.pptx)、Excel (.xlsx, .xls)
  • 网页/数据:HTML、CSV、JSON、XML
  • 媒体:图片(EXIF + OCR)、音频(EXIF + 转录)
  • 其他:ZIP(遍历内容)、YouTube 链接、EPub

选项

-o OUTPUT      # 输出文件
-x EXTENSION   # 提示文件扩展名(用于标准输入)
-m MIME_TYPE   # 提示 MIME 类型
-c CHARSET     # 提示字符集(例如 UTF-8)
-d             # 使用 Azure Document Intelligence
-e ENDPOINT    # Document Intelligence 端点
--use-plugins  # 启用第三方插件
--list-plugins # 显示已安装的插件

示例

# 转换 Word 文档
uvx markitdown report.docx -o report.md

# 转换 Excel 电子表格
uvx markitdown data.xlsx > data.md

# 转换 PowerPoint 演示文稿
uvx markitdown slides.pptx -o slides.md

# 使用文件类型提示进行转换(针对标准输入)
cat document | uvx markitdown -x .pdf > output.md

# 使用 Azure Document Intelligence 提高 PDF 提取质量
uvx markitdown scan.pdf -d -e "https://your-resource.cognitiveservices.azure.com/"

注意事项

  • 输出结果保留文档结构:标题、表格、列表、链接
  • 首次运行会缓存依赖,后续执行更快
  • 对于复杂 PDF(提取效果不佳),请使用 -d 配合 Azure Document Intelligence

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

相关技能