← Back to Skills Marketplace
Markdown Anything
by
Aditya Tripathi
· GitHub ↗
· v1.0.0
378
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install markdown-anything
Description
Convert PDF, DOCX, XLSX, PPTX, images, audio, and 25+ file formats to clean Markdown using the Markdown Anything API.
README (SKILL.md)
Markdown Anything
Convert files to clean, structured Markdown using the Markdown Anything API. Supports PDF, DOCX, XLSX, PPTX, images, audio, and 25+ formats.
Setup
Set your API token as an environment variable. Get one from Settings > API Tokens in your Markdown Anything workspace.
MDA_API_TOKEN=mda_your_token_here
When to Use
Use the mda-convert tool when the user asks to:
- Convert a file to Markdown
- Extract text from a PDF, document, image, or audio file
- Turn a document into Markdown for use in a prompt or workflow
Tools
mda-convert
Converts a file to Markdown. Run scripts/convert.sh with the file path as the first argument.
Arguments:
$1— Path to the file to convert
Optional environment variables:
MDA_ENHANCED_AI=true— Use Enhanced AI for scanned documents, images, and audio (costs extra credits)MDA_INCLUDE_METADATA=true— Include document metadata in the responseMDA_OPTIMIZE_TOKENS=true— Optimize output for LLM token efficiency
Example:
scripts/convert.sh /path/to/document.pdf
The tool outputs the converted Markdown to stdout.
mda-credits
Check your remaining credit balance. Run scripts/credits.sh with no arguments.
Example:
scripts/credits.sh
Security & Privacy
- Files are sent to
https://markdownanything.com/api/v1/convertfor processing - Your API token is sent via the
Authorizationheader - No data is stored locally beyond the conversion result
- See Markdown Anything Privacy Policy for data handling details
Usage Guidance
This skill appears to be what it says: it uploads the file you provide to markdownanything.com and returns Markdown. Before installing or using it: (1) understand that any file you convert will be transmitted to https://markdownanything.com — do not upload sensitive data unless you trust the service and have read its privacy policy; (2) provide only a token from the official Markdown Anything workspace (MDA_API_TOKEN) and avoid reusing high-privilege secrets; (3) ensure curl and python3 are available in the execution environment (the scripts require them, but the registry metadata does not declare them); (4) verify the homepage and token retrieval flow (source is listed as unknown, which lowers confidence); (5) if you need stronger assurance, run the scripts in an isolated environment (or inspect and run them manually) and confirm network egress rules; and (6) prefer tokens with limited scope/rotation and monitor usage/credit balance after first use.
Capability Analysis
Type: OpenClaw Skill
Name: markdown-anything
Version: 1.0.0
The skill bundle is designed to convert files to Markdown using the Markdown Anything API. The `SKILL.md` clearly documents that files and an API token are sent to `https://markdownanything.com` for processing, which is the core functionality. The `scripts/convert.sh` and `scripts/credits.sh` implement this functionality directly using `curl` and `python3` for JSON parsing. There is no evidence of intentional malicious behavior such as unauthorized data exfiltration, persistence mechanisms, or prompt injection attempts against the agent. All actions align with the stated purpose and are explicitly documented.
Capability Assessment
Purpose & Capability
The skill claims to convert many file types via the Markdown Anything API and only requires MDA_API_TOKEN — that aligns with the stated purpose. However, the bundled scripts invoke curl and python3 but the registry metadata lists no required binaries; the missing declaration is an inconsistency the user should be aware of.
Instruction Scope
SKILL.md and the scripts stay on-purpose: they send the provided file to https://markdownanything.com/api/v1/convert and return the Markdown result. This does mean user files are transmitted to a third-party endpoint (explicitly documented). No other local files or unrelated environment variables are accessed.
Install Mechanism
There is no install spec (instruction-only plus two small scripts). Nothing is downloaded or written to disk by an installer, so installation risk is low.
Credentials
Only MDA_API_TOKEN is required (primary credential) and the optional flags are narrowly scoped to conversion behavior. The requested environment variables are proportional to the skill's purpose.
Persistence & Privilege
The skill does not request permanent presence (always is false), does not modify other skills or system settings, and does not store secrets. Autonomous invocation is allowed (platform default) but not unusually privileged here.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install markdown-anything - After installation, invoke the skill by name or use
/markdown-anything - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of the markdown-anything skill.
- Convert 25+ file formats—including PDF, DOCX, XLSX, PPTX, images, and audio—to clean Markdown using the Markdown Anything API.
- Provides two tools: `mda-convert` for file conversion and `mda-credits` to check credit balance.
- Requires `MDA_API_TOKEN` for authentication.
- Optional environment variables for advanced conversion options (Enhanced AI, metadata, token optimization).
- Includes setup instructions and privacy/security details.
Metadata
Frequently Asked Questions
What is Markdown Anything?
Convert PDF, DOCX, XLSX, PPTX, images, audio, and 25+ file formats to clean Markdown using the Markdown Anything API. It is an AI Agent Skill for Claude Code / OpenClaw, with 378 downloads so far.
How do I install Markdown Anything?
Run "/install markdown-anything" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Markdown Anything free?
Yes, Markdown Anything is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Markdown Anything support?
Markdown Anything is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Markdown Anything?
It is built and maintained by Aditya Tripathi (@adiologydev); the current version is v1.0.0.
More Skills