# Send File to Markdown Converter to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "file-to-markdown",
    "name": "File to Markdown Converter",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/alaminrifat/file-to-markdown",
    "canonicalUrl": "https://clawhub.ai/alaminrifat/file-to-markdown",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/file-to-markdown",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=file-to-markdown",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "readme.txt",
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/file-to-markdown"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/file-to-markdown",
    "downloadUrl": "https://openagent3.xyz/downloads/file-to-markdown",
    "agentUrl": "https://openagent3.xyz/skills/file-to-markdown/agent",
    "manifestUrl": "https://openagent3.xyz/skills/file-to-markdown/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/file-to-markdown/agent.md"
  }
}
```
## Documentation

### 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

### 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

### 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"

### 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
  }
}

### 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

### 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 TypeActionPublic file URLUse GET or POSTLocal fileUse POST /convertImageConvert then summarizeSpreadsheetConvert then analyzeWebpageConvert 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.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: alaminrifat
- Version: 1.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-23T16:43:11.935Z
- Expires at: 2026-04-30T16:43:11.935Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/file-to-markdown)
- [Send to Agent page](https://openagent3.xyz/skills/file-to-markdown/agent)
- [JSON manifest](https://openagent3.xyz/skills/file-to-markdown/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/file-to-markdown/agent.md)
- [Download page](https://openagent3.xyz/downloads/file-to-markdown)