Convert files to beautifully formatted Markdown. TRIGGER when user asks to convert a file to Markdown, extract text from PDF/DOCX/PPTX/XLSX, or format a document as Markdown.
Convert files to beautifully formatted Markdown in two steps: convert with uvx markitdown[all], then beautify with configurable style formatting.
/1coos-markdown-converter <file-path> [--style github|commonmark|clean|obsidian] [--output-dir path] [--convert-only]
| Parameter | Required | Description |
|---|---|---|
<file-path> | Yes | Path to the file to convert |
--style | No | Formatting style: github (default), commonmark, clean, obsidian |
--output-dir |
| No |
Output directory (default: skills/1coos-markdown-converter/output) |
--convert-only | No | Only convert, skip formatting step |
--config | No | Path to config.json (default: skill directory config.json) |
GitHub Flavored Markdown — table column alignment, fenced code blocks, task lists.
Strict CommonMark — enforces sequential heading levels (no skipping h1 to h3).
Minimal style — removes excessive formatting, simplifies redundant links.
Obsidian Flavored Markdown — converts internal links to [[wikilinks]], normalizes callout syntax (> [!type]), formats properties/frontmatter, normalizes ==highlight== syntax, and aligns tables. Ideal for notes destined for Obsidian vaults.
Core parameters are configurable via config.json in the skill directory:
{
"style": "github",
"outputDir": null,
"convertOnly": false,
"formatting": {
"maxWidth": 80,
"listMarker": "-",
"emphasisMarker": "*",
"strongMarker": "**",
"codeBlockStyle": "fenced"
},
"converter": {
"timeout": 60000,
"charset": "UTF-8"
}
}
CLI arguments always override config.json values.
When the user invokes this skill:
uvx is available. If not, instruct the user to install uv: curl -LsSf https://astral.sh/uv/install.sh | shbun run ${CLAUDE_SKILL_DIR}/scripts/main.ts $ARGUMENTS
# Convert a PDF with default github style
/1coos-markdown-converter report.pdf
# Convert Word document with clean style
/1coos-markdown-converter document.docx --style clean
# Convert Excel to markdown without formatting
/1coos-markdown-converter data.xlsx --convert-only
# Specify output directory
/1coos-markdown-converter slides.pptx --output-dir ~/notes
markitdown[all] dependencies; subsequent runs are fastermarkitdown[all] to ensure full format support (PDF, OCR, audio transcription)