ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

1coos-markdown-converter

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.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/1coos/1coos-markdown-converter
Or

Markdown Converter

Convert files to beautifully formatted Markdown in two steps: convert with uvx markitdown[all], then beautify with configurable style formatting.

Usage

/1coos-markdown-converter <file-path> [--style github|commonmark|clean|obsidian] [--output-dir path] [--convert-only]

Parameters

ParameterRequiredDescription
<file-path>YesPath to the file to convert
--styleNoFormatting style: github (default), commonmark, clean, obsidian
--output-dirNoOutput directory (default: skills/1coos-markdown-converter/output)
--convert-onlyNoOnly convert, skip formatting step
--configNoPath to config.json (default: skill directory config.json)

Supported Formats

  • Documents: PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls)
  • Web/Data: HTML, CSV, JSON, XML
  • Media: Images (EXIF + OCR), Audio (EXIF + transcription)
  • Other: ZIP (iterates contents), YouTube URLs, EPub

Formatting Styles

github (default)

GitHub Flavored Markdown — table column alignment, fenced code blocks, task lists.

commonmark

Strict CommonMark — enforces sequential heading levels (no skipping h1 to h3).

clean

Minimal style — removes excessive formatting, simplifies redundant links.

obsidian

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.

Configuration

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.

Execution Instructions

When the user invokes this skill:

  1. Check prerequisites: Verify uvx is available. If not, instruct the user to install uv: curl -LsSf https://astral.sh/uv/install.sh | sh
  2. Run conversion: Execute the script: 
    bun run ${CLAUDE_SKILL_DIR}/scripts/main.ts $ARGUMENTS
  3. Report results: Show the output file path and a brief summary of the conversion.
  4. Handle errors:
    • Exit code 2: argument error — show the specific error message
    • Exit code 3: missing dependency — guide user to install uv
    • Exit code 4: conversion failure — suggest checking file format support

Examples

# 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
Read Full Documentation on GitHub

Metadata

Author@1coos
Stars4473
Views0
Updated2026-05-01
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-1coos-1coos-markdown-converter": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.

Related Skills

1coos-quickie

Quickly save web content as formatted Markdown. TRIGGER when user pastes a URL and wants to save/clip it, read-later, or extract content from YouTube, Twitter/X, WeChat, Bilibili, Telegram, RSS, or any web page.

1coos 4473

1coos-calendar-cn

查询中国传统日历/黄历信息。TRIGGER when user asks about Chinese calendar, lunar date, 农历, 黄历, 万年历, 节气, 五行， 宜忌, 干支，佛历，道历等。

1coos 4473