← 返回 Skills 市场

1coos-markdown-converter

Name: 1coos-markdown-converter
Author: 1coos

作者 1coos · GitHub ↗ · v1.0.1 · MIT-0

cross-platform ✓ 安全检测通过

154

总下载

当前安装

版本数

在 OpenClaw 中安装

/install 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 docu...

使用说明 (SKILL.md)

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 \x3Cfile-path> [--style github|commonmark|clean|obsidian] [--output-dir path] [--convert-only]

Parameters

Parameter	Required	Description
`\x3Cfile-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)

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:

Check prerequisites: Verify uvx is available. If not, instruct the user to install uv: curl -LsSf https://astral.sh/uv/install.sh | sh

Run conversion: Execute the script:

bun run ${CLAUDE_SKILL_DIR}/scripts/main.ts $ARGUMENTS

Report results: Show the output file path and a brief summary of the conversion.
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

# Convert Excel to markdown without formatting
/1coos-markdown-converter data.xlsx --convert-only

# Specify output directory
/1coos-markdown-converter slides.pptx --output-dir ~/notes

Notes

First run caches markitdown[all] dependencies; subsequent runs are faster
Uses markitdown[all] to ensure full format support (PDF, OCR, audio transcription)
Output preserves document structure: headings, tables, lists, links
For complex PDFs with poor extraction, consider using Azure Document Intelligence

安全使用建议

This skill appears to do what it says, but check a few things before installing: 1) Fix the filename mismatch: SKILL.md runs scripts/main.ts but the bundle provides scripts/main.js — confirm the runtime command will actually invoke the included script. 2) Ensure you want the 'markitdown[all]' bundle: the 'all' variant pulls in OCR, audio-transcription and PDF toolchains (potentially large native deps). 3) Confirm you are comfortable with the uv/uvx installer (the SKILL.md points to the official astral.sh installer) and that your environment has bun available. 4) If you plan to use Azure Document Intelligence, prepare and secure any Azure endpoint/credentials — the skill mentions that feature but does not declare or manage Azure secrets itself. 5) Test with non-sensitive files first to validate behavior. If you are not comfortable with the installer/network downloads or with enabling optional cloud OCR/transcription, do not install or run the skill until those concerns are resolved.

功能分析

Type: OpenClaw Skill Name: 1coos-markdown-converter Version: 1.0.1 The skill is a legitimate utility for converting various file formats (PDF, DOCX, XLSX, etc.) to Markdown using the Microsoft 'markitdown' tool via 'uvx'. The code in 'scripts/main.js' implements robust string manipulation for different Markdown styles (GitHub, Obsidian, etc.) and uses 'Bun.spawn' safely to execute the conversion without shell injection risks. No evidence of data exfiltration, malicious execution, or prompt injection was found; the instructions and logic are entirely consistent with the stated purpose.

能力评估

ℹ Purpose & Capability

The name/description (convert many file types to Markdown) matches the code and install spec: the skill runs a local converter (markitdown[all]) and then formats the Markdown. Requested binaries (bun to run the included script, uvx to run or install the markitdown package) are reasonable for this purpose. Minor inconsistencies: the install spec uses an 'uv' package entry while runtime checks and instructions reference 'uvx'; SKILL.md instructs 'bun run ${CLAUDE_SKILL_DIR}/scripts/main.ts' but the bundle contains scripts/main.js (filename/type mismatch) which could cause runtime failures.

ℹ Instruction Scope

Runtime instructions are focused on converting a user-supplied file and formatting the output; the code checks file existence, runs the converter, and applies formatting. The skill may read an optional config.json in its own directory. It does not request or attempt to read unrelated system files or environment variables. Note: it supports optional Azure Document Intelligence (mentioned in docs) but does not declare Azure credentials — using that feature would require extra configuration outside this bundle.

ℹ Install Mechanism

The install spec installs markitdown[all] via 'uv' (astral/uv ecosystem). This will pull in the 'all' set of dependencies (OCR, audio transcription, PDF tooling), which can be large and may pull native libraries. The installer referenced in SKILL.md (https://astral.sh/uv/install.sh) is the official uv installer URL, not an opaque shortener or personal host. This is a moderate-risk install because it downloads external packages/dependencies, but it's coherent for a converter that claims OCR and audio transcription support.

ℹ Credentials

The skill declares no required environment variables or credentials, which matches the bundle. One caveat: the docs reference optional Azure Document Intelligence usage (CLI flags -d / -e) — enabling that would require an Azure endpoint or credential configured outside the declared requirements. No other unrelated credentials are requested.

✓ Persistence & Privilege

The skill does not request persistent or system-wide privileges (always is false). It does not attempt to modify other skills or system-wide agent configuration. It only installs/uses the markitdown binary and caches dependencies in the normal uv ecosystem.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install 1coos-markdown-converter
安装完成后，直接呼叫该 Skill 的名称或使用 /1coos-markdown-converter 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.1

- Major refactor: removed TypeScript source, configs, and tests; now uses a single main.js script. - SKILL.md updated to reflect current capabilities and simplified description. - Configuration options and usage instructions remain unchanged for end users. - Streamlined maintenance by consolidating codebase and removing redundant files.

v1.0.0

Initial release of 1coos-markdown-converter. - Converts files (PDF, DOCX, PPTX, XLSX, HTML, CSV, JSON, XML, images, audio, EPub) to beautified Markdown using uvx markitdown[all] - Supports multiple Markdown formatting styles: github (default), commonmark, clean, obsidian - CLI usage with parameters to customize style, output directory, and conversion options - Configuration via CLI arguments or config.json for flexible control - Handles prerequisites, errors, and provides clear user guidance - Preserves document structure (headings, tables, lists, links) and supports OCR/audio transcription

元数据

Slug 1coos-markdown-converter

版本 1.0.1

许可证 MIT-0

累计安装 1

当前安装数 1

历史版本数 2

常见问题