Community寫作與編輯github.com

steipete/markdown-converter

將常見文件格式(PDF、Office、HTML、媒體等)轉換為 Markdown,無需安裝。

markdown-converter 是什麼?

Markdown Converter 是一個以 `uvx markitdown` 為核心的工具,讓 AI Agent 能直接將多種格式的文件轉換為 Markdown,無需手動安裝額外套件。它支援 PDF、Word、PowerPoint、Excel、HTML、CSV、JSON、XML、圖片(含 OCR)、音訊(含語音轉寫)、ZIP 壓縮檔以及 YouTube 連結等廣泛的輸入格式。開發者可以透過簡單的 CLI 指令進行轉換,例如 `uvx markitdown input.pdf -o output.md` 即可將 PDF 輸出為 Markdown 檔案。此工具特別適合需要自動化批次處理文件、提取結構化內容的 CI/CD 流程與 AI Agent 整合。對於複雜的 PDF,還可選擇啟用 Azure Document Intelligence 以獲得更精準的版面分析與文字識別結果。

相容平台~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 轉換器

使用 uvx markitdown 將檔案轉換為 Markdown — 無需安裝。

基本用法

# 轉換並輸出到終端機
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.

相關技能