notque/markdown-converter
skills/research/markdown-converter/SKILL.md
Convert PDF, Office, HTML, data, media, ZIP to Markdown.
$ install --global
skillsauthnpx skillsauth add notque/claude-code-toolkit markdown-converterInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jul 6, 2026, 5:11 AM122.0s1 file scanned
SKILL.md
- 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
- category:
- research
Markdown 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-transcript 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.
Related Skills
notque/shell-config
tools
VerifiedTrustedCommunity
Shell configuration: Fish and Zsh setup, PATH, completions, plugins.
412SKILL.mdUpdated Jul 6, 2026
notque/kubernetes
tools
VerifiedTrustedCommunity
Kubernetes operations: debugging, security, RBAC, and infrastructure tooling.
412SKILL.mdUpdated Jul 6, 2026
notque/swift
development
VerifiedTrustedCommunity
Swift development: concurrency patterns, async/await, actors, testing with XCTest and Swift Testing framework.
412SKILL.mdUpdated Jul 6, 2026
notque/php
development
VerifiedTrustedCommunity
PHP development: code quality, PSR standards, testing with PHPUnit.
412SKILL.mdUpdated Jul 6, 2026