assessment
Assessment: read-only inspection, codebase overview, value analysis, health checks, ADR consultation, decision analysis,…
@notqueInstall SkillDevelopment
Skill
/markdown-converter
Convert PDF, Office, HTML, data, media, ZIP to Markdown.
Claude Code
$ npx -y skills add notque/vexjoy-agent --skill markdown-converter --agent claude-code
Codex
$ npx skills add notque/vexjoy-agent --skill markdown-converter -a codex -y
Cursor
$ npx skills add notque/vexjoy-agent --skill markdown-converter -a cursor -y
Gemini CLI
$ npx skills add notque/vexjoy-agent --skill markdown-converter -a gemini-cli -y
GitHub Copilot
$ npx skills add notque/vexjoy-agent --skill markdown-converter -a github-copilot -y
OpenCode
$ npx skills add notque/vexjoy-agent --skill markdown-converter -a opencode -y
Windsurf
$ npx skills add notque/vexjoy-agent --skill markdown-converter -a windsurf -y
SKILL.md
markdown-converter.SKILL.mdname: markdown-converter
description: "Convert PDF, Office, HTML, data, media, ZIP to Markdown."
user-invocable: false # default -- router-dispatched, not user-typed
agent: python-general-engineer
allowed-tools:
- Bash
- Read
routing:
triggers:
- "convert to markdown"
- "markitdown"
- "extract text from PDF"
- "PDF to markdown"
- "docx to markdown"
- "ingest document"
- "read this PDF"
- "read this document"
- "extract text from document"
- "convert PDF"
- "convert document"
- "pptx to markdown"
- "xlsx to markdown"
category: research
pairs_with:
- research
- domainMarkdown Converter
Convert a file to Markdown with markitdown, zero install:
uvx 'markitdown[all]' input.pdf -o output.md # to file
uvx 'markitdown[all]' input.docx # to stdout
cat blob | uvx 'markitdown[all]' -x .pdf # stdin, with extension hint
When `uvx` is missing, run `pipx run 'markitdown[all]' …` with the same arguments. First run downloads dependencies; later runs hit the cache. Output preserves headings, tables, lists, and links.
For video transcripts, use the `video-editing` skill.
Formats
| Input | Notes | |---|---| | PDF, .docx, .pptx, .xlsx, .xls | Document structure preserved | | HTML, CSV, JSON, XML | Structured Markdown | | Images | EXIF metadata + OCR text | | Audio | EXIF metadata + speech transcription | | ZIP, EPub | Iterates contents, converts each |
Options
| Flag | Effect | |---|---| | `-o FILE` | Write output to FILE | | `-x .EXT` | Extension hint for stdin input | | `-m MIME` | MIME-type hint | | `-c CHARSET` | Charset hint, e.g. UTF-8 |
Error handling
Garbled or empty text from a scanned PDF
Cause: page is an image; the base extractor reads text layers only. Solution: render pages to images (`pdftoppm`), then convert the images so OCR runs.
Read more
name: markdown-converter
description: "Convert PDF, Office, HTML, data, media, ZIP to Markdown."
user-invocable: false # default -- router-dispatched, not user-typed
agent: python-general-engineer
allowed-tools:
- Bash
- Read
routing:
triggers:
- "convert to markdown"
- "markitdown"
- "extract text from PDF"
- "PDF to markdown"
- "docx to markdown"
- "ingest document"
- "read this PDF"
- "read this document"
- "extract text from document"
- "convert PDF"
- "convert document"
- "pptx to markdown"
- "xlsx to markdown"
category: research
pairs_with:
- research
- domainMarkdown Converter
Convert a file to Markdown with markitdown, zero install:
uvx 'markitdown[all]' input.pdf -o output.md # to file uvx 'markitdown[all]' input.docx # to stdout cat blob | uvx 'markitdown[all]' -x .pdf # stdin, with extension hint
When `uvx` is missing, run `pipx run 'markitdown[all]' …` with the same arguments. First run downloads dependencies; later runs hit the cache. Output preserves headings, tables, lists, and links.
For video transcripts, use the `video-editing` skill.
Formats
| Input | Notes | |---|---| | PDF, .docx, .pptx, .xlsx, .xls | Document structure preserved | | HTML, CSV, JSON, XML | Structured Markdown | | Images | EXIF metadata + OCR text | | Audio | EXIF metadata + speech transcription | | ZIP, EPub | Iterates contents, converts each |
Options
| Flag | Effect | |---|---| | `-o FILE` | Write output to FILE | | `-x .EXT` | Extension hint for stdin input | | `-m MIME` | MIME-type hint | | `-c CHARSET` | Charset hint, e.g. UTF-8 |
Error handling
Garbled or empty text from a scanned PDF
Cause: page is an image; the base extractor reads text layers only. Solution: render pages to images (`pdftoppm`), then convert the images so OCR runs.
Stats
449
Stars
51
Forks
Active
Maintenance
Python
Language
MIT
License
Last commit
Created
Ships withvexjoy-agent
Essays and writing behind this toolkit live at vexjoy.com. VexJoy Agent connects plain-English requests to specialist agents, skills, and workflows. /do selects the knowledge and tools needed for your task.
44964 skills198 agents
Stars on GitHub
Momentum
- stars in total
- 449
Other skills on vexjoy-agent.
@notqueInstall Skillbusiness-ops
Business operations: strategy, technology, growth, competitive intelligence, support, finance, HR, legal, operations, sales,…
@notqueInstall SkillMore skills from other plugins.
Auto-invoked
brainstorming
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…
@obraInstall Skillask-matt
Ask which skill or flow fits your situation. A router over the skills in this repo.
@mattpocockInstall SkillAuto-invoked
Questions about markdown-converter.
- Which coding agents can use markdown-converter?
- markdown-converter installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.