ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

formatferry

Convert HTML, DOCX, PDF, XLSX, CSV to Markdown

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/britrik/formatferry-markdown
Or

formatferry Skill

Convert HTML, DOCX, PDF, XLSX, CSV files to Markdown using the Format Ferry CLI.

Installation

Install the CLI globally:

npm install -g formatferry

Or use npx (requires Node.js):

npx formatferry --help

Authentication

The user has a private API key. Do NOT expose this key in any output or messages.

# Authenticate
scripts/auth.sh --key <API_KEY>

# Check status
scripts/auth.sh --status

Scripts

This skill includes secure wrapper scripts with no eval and bash arrays for safe argument handling:

scripts/convert-to-md.sh (recommended)

# Convert a local file
scripts/convert-to-md.sh --input /path/to/file.pdf --output output.md --format github

# Convert a URL
scripts/convert-to-md.sh --url https://example.com/article --output article.md

scripts/convert.sh (legacy)

scripts/convert.sh --file input.html --output result.md --format github
scripts/convert.sh --url https://example.com --output article.md

Supported formats: github, commonmark, slack, discord, reddit, confluence, custom, rmarkdown

Supported File Types

  • .html - Web pages
  • .docx - Word documents
  • .pdf - PDF files (up to 20MB)
  • .xlsx - Excel spreadsheets
  • .csv - CSV files

Security Notes

  • No eval: All scripts use bash arrays for safe argument passing
  • No OOM risk: Output streams directly to file + stdout, never captured in shell variables
  • Recursive path sanitization: Loops repeatedly to strip ....//, ..../, ./, and encoded bypasses (%2e%2e)
  • Path validation: Blocks writes to /etc, /root, /sys, /proc and sensitive files (passwd, shadow, id_rsa)
  • Realpath verification: Validates final paths are within allowed WORKDIR before execution
  • URL validation: Rejects malformed URLs (must start with http:// or https://)

Provenance

Notes

  • API key stored locally after authentication
  • Premium features may require a license key
  • Output format defaults to "github" if not specified
Read Full Documentation on GitHub

Metadata

Author@britrik
Stars4190
Views0
Updated2026-04-18
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-britrik-formatferry-markdown": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.

Related Skills

elevenlabs-twilio-memory-bridge

FastAPI personalization webhook that adds persistent caller memory and dynamic context injection to ElevenLabs Conversational AI agents on Twilio. No audio proxying, file-based persistence, OpenClaw compatible.

britrik 4190

skill-vettr

Static analysis security scanner for third-party OpenClaw skills. Detects eval/spawn risks, malicious dependencies, typosquatting, and prompt injection patterns before installation. Use when vetting skills from ClawHub or untrusted sources.

britrik 4190

skill-vettr

Static analysis security scanner for third-party OpenClaw skills. Detects eval/spawn risks, malicious dependencies, typosquatting, and prompt injection patterns before installation. Use when vetting skills from ClawHub or untrusted sources.

britrik 1865