AgentSkillsCN

markdown-converter

使用 markitdown 将各类文档转换为 Markdown 格式。当您需要从 PDF、Word、PowerPoint、Excel、HTML、CSV、JSON、XML、带有 EXIF/OCR 的图片、音频、ZIP 压缩包、YouTube 视频链接或 EPUB 文件中提取文本，并将其转换为 Markdown 格式，以便用于大语言模型处理或文本分析时，此技能便能大显身手。

SKILL.md
--- frontmatter
name: markdown-converter
description: Convert documents to Markdown using markitdown. Use when you need to extract text and convert PDF, Word, PowerPoint, Excel, HTML, CSV, JSON, XML, images (with EXIF/OCR), audio, ZIP archives, YouTube URLs, or EPUBs to Markdown format for LLM processing or text analysis.
license: MIT
compatibility: opencode
metadata:
  audience: developers
  workflow: automated

Markdown Converter

Overview

This skill uses markitdown to convert various document formats to Markdown. It provides a reliable conversion tool for extracting content from PDFs, Word documents, presentations, spreadsheets, and many other file formats.

Instructions

Use the convert.sh script to convert files to Markdown:

bash
~/.config/opencode/skill/markdown-converter/scripts/convert.sh <input_file> [output_file]
  • •Provide an input file path to convert
  • •Optionally specify an output file path (defaults to stdout)
  • •Supported formats: PDF, DOCX, PPTX, XLSX, HTML, CSV, JSON, XML, images, audio, ZIP, YouTube, EPUB

Examples

Convert a PDF to Markdown and save to file:

code
~/.config/opencode/skill/markdown-converter/scripts/convert.sh document.pdf document.md

Convert a Word document and output to stdout:

code
~/.config/opencode/skill/markdown-converter/scripts/convert.sh report.docx

Convert an Excel spreadsheet:

code
~/.config/opencode/skill/markdown-converter/scripts/convert.sh data.xlsx data.md

Direct markitdown usage:

code
/Users/johannwaldherr/.local/bin/markitdown document.pdf -o document.md