file-to-markdown
暂无简介
- License 许可
- MIT
- 最近更新
- 2026-06-07
- Stars
- ★ 0
- Forks
- 1
03 SKILL.md 正文
File to Markdown — Skill
Overview
Convert files into clean, structured, AI-ready Markdown using the markdown.new API powered by Cloudflare Workers AI toMarkdown().
Supports 20+ formats including documents, spreadsheets, images, and structured data.
No authentication required (500 requests/day per IP).
When to Use This Skill
Use this skill whenever you need to:
- Extract text from files for LLM processing
- Convert PDFs or Office files into Markdown
- Normalize data into structured text
- Process uploaded user files
- Scrape webpage content into Markdown
- Convert images into AI-generated descriptions + content
Common AI workflows:
- RAG ingestion pipelines
- Knowledge base creation
- Document summarization
- Dataset extraction
- Spreadsheet analysis
- OCR-like extraction from images
Supported Formats
Documents
.pdf.docx.odt
Spreadsheets
.xlsx.xls.xlsm.xlsb.et.ods.numbers
Images
.jpg.jpeg.png.webp.svg
Text & Structured Data
.txt.md.csv.json.xml.html.htm
Notes:
- Image conversion uses AI object detection + summarization.
- HTML URL conversion uses a web page pipeline.
- Uploaded HTML uses Workers AI conversion.
API Base URL
https://markdown.new
Endpoints
1️⃣ Convert Remote File (Simple GET)
Returns plain Markdown text.
GET /:file-url
Example:
curl -s "https://markdown.new/https://example.com/report.pdf"
2️⃣ Convert Remote File (JSON Response)
Returns metadata + Markdown.
GET /:file-url?format=json
Example:
curl -s "https://markdown.new/https://example.com/report.pdf?format=json"
3️⃣ Convert Remote File via POST
Use when you want structured JSON response.
POST /
Content-Type: application/json
Body:
{
"url": "https://example.com/report.pdf"
}
Example:
curl -s https://markdown.new/ \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/report.pdf"}'
4️⃣ Upload Local File
Use when file is not publicly accessible.
POST /convert
multipart/form-data
Example:
curl -s https://markdown.new/convert \
-F "file=@document.pdf"
Response Formats
URL Conversion Response
{
"success": true,
"url": "https://example.com/report.pdf",
"title": "Quarterly Report",
"content": "# Quarterly Report\n\n...",
"method": "Workers AI (file)",
"duration_ms": 1200,
"tokens": 850
}
Upload Conversion Response
{
"success": true,
"data": {
"title": "Q4 Report",
"content": "# Q4 Report\n\n...",
"filename": "report.xlsx",
"file_type": ".xlsx",
"tokens": 1250,
"processing_time_ms": 320
}
}
Best Practices for AI Agents
Prefer GET for Simple Workflows
Use:
GET /:url
When:
- You only need Markdown text
- Speed is important
- No metadata required
Prefer POST for Structured Pipelines
Use POST when:
- Metadata is needed
- Token counts are required
- Monitoring or logging is implemented
- Building automation workflows
File Upload Strategy
Use /convert only if:
- File is local
- File is private
- File requires authentication to access
Otherwise always prefer URL conversion.
Error Handling Strategy
Agents should:
- Check
"success": true - Retry once if network failure
- Validate content length > 0
- Fallback to alternate extraction if needed
Rate Limits
- 500 requests/day per IP without API key
- No signup required
Agents should:
- Cache results when possible
- Avoid duplicate conversions
Integration Examples
JavaScript (Node.js)
const res = await fetch("https://markdown.new/", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
url: "https://example.com/file.pdf"
})
});
const data = await res.json();
console.log(data.content);
Python
import requests
res = requests.post(
"https://markdown.new/",
json={"url": "https://example.com/file.pdf"}
)
data = res.json()
print(data["content"])
Agent Decision Tree
If user provides:
| Input Type | Action |
|---|---|
| Public file URL | Use GET or POST |
| Local file | Use POST /convert |
| Image | Convert then summarize |
| Spreadsheet | Convert then analyze |
| Webpage | Convert URL HTML |
Output Expectations
The Markdown should be:
- Clean
- Structured
- AI-friendly
- Minimal noise
- Ready for LLM ingestion
Limitations
- Complex PDF layouts may lose formatting
- Large spreadsheets may be truncated
- Images rely on AI interpretation accuracy
- Token limits may apply
Summary
This skill provides a universal file-to-Markdown conversion layer for AI systems with:
- No authentication
- Simple HTTP interface
- Multi-format support
- Structured output
- Fast processing
Ideal for document ingestion, RAG pipelines, and automation agents.
04 同仓库更多 Skills
crowd-prompting
A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.
ceaser
Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir/UltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).
ceaser-send
Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir/UltraHonk zero-knowledge proofs.
dilemm-ai
Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).
moldium
Post and manage content on the Moldium blog platform. Triggered by "post to Moldium", "write a blog post", "publish an article", etc.
arxiv-paper-reviews
Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date/category/interest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http://weakaccept.top:8000/.