markdown-converter について
markdown-converterは、別途インストールせずに`uvx markitdown`でファイルをMarkdownへ変換するスキルです。文書構造を保ったMarkdown出力が必要なワークフローに適しています。
主な機能
- 01インストール不要で変換を実行
- 02文書、Web、データ形式に対応
- 03画像OCRと音声文字起こし
- 04見出し、表、リスト、リンクを保持
- 05プラグインとAzure Document Intelligenceに対応
活用シーン
- 01PDF、Word、プレゼンテーションをMarkdownに変換
- 02CSV、JSON、HTMLを読みやすいテキストに変換
- 03画像や音声からテキストを抽出
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ intellectronica/ agent-skills --skill markdown-converterインストール後、Claude Code で/markdown-converterを入力して読み込まれたか確認します。
詳細
Markdown 変換ツール
インストール不要で、uvx markitdown を使用してファイルを Markdown に変換します。
基本的な使い方
# Convert to stdout
uvx markitdown input.pdf
# Save to file
uvx markitdown input.pdf -o output.md
uvx markitdown input.docx > output.md
# From stdin
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 # Output file
-x EXTENSION # Hint file extension (for stdin)
-m MIME_TYPE # Hint MIME type
-c CHARSET # Hint charset (e.g., UTF-8)
-d # Use Azure Document Intelligence
-e ENDPOINT # Document Intelligence endpoint
--use-plugins # Enable 3rd-party plugins
--list-plugins # Show installed plugins
例
# Convert Word document
uvx markitdown report.docx -o report.md
# Convert Excel spreadsheet
uvx markitdown data.xlsx > data.md
# Convert PowerPoint presentation
uvx markitdown slides.pptx -o slides.md
# Convert with file type hint (for stdin)
cat document | uvx markitdown -x .pdf > output.md
# Use Azure Document Intelligence for better PDF extraction
uvx markitdown scan.pdf -d -e "https://your-resource.cognitiveservices.azure.com/"
注記
- 出力では、見出し、表、リスト、リンクなど、ドキュメントの構造が保持されます
- 初回実行時に依存関係がキャッシュされ、以降の実行はより高速になります
- 抽出精度の低い複雑な PDF には、Azure Document Intelligence とともに
-dを使用してください
コメント
Markdown 対応