Communityライティング&編集github.com

steipete/markdown-converter

Markdown変換: PDF、Office、HTML、データ、OCR、音声、ZIP、YouTube。

markdown-converter とは?

このスキルは、`uvx markitdown` コマンドを使用して、さまざまなファイル形式をMarkdownに変換するためのものです。インストール不要で、PDF、Word、PowerPoint、Excel、HTML、CSV、JSON、XML、画像(OCR対応)、音声、ZIPファイル、さらにはYouTube動画など、幅広い形式に対応しています。標準出力への出力やファイル保存、標準入力からの変換が可能で、Azure Document Intelligenceを利用することで複雑なPDFからの高精度なテキスト抽出も実現できます。Claude CodeやCursorなどのAIエージェントと連携し、文書構造を保持したまま効率的にデータを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に質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Markdown Converter

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)
  • Web/データ: HTML、CSV、JSON、XML
  • メディア: 画像 (EXIF + OCR)、音声 (EXIF + 文字起こし)
  • その他: ZIP(内容を反復処理)、YouTube URL、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.

関連スキル