MeetMarkdown

API for Developers & AI Agents

Free REST API to format, convert, diff, and analyze markdown. Built for developers, scripts, and AI agents. No authentication required.

AI Agent Integration

MeetMarkdown is designed for AI agents out of the box. Your agent can discover our tools automatically and call them via standard REST.

llms.txt

Emerging standard for AI-native site discovery. Point your agent at /llms.txt to learn what tools are available.

OpenAPI 3.1 Spec

Machine-readable API spec at /.well-known/openapi.json. Auto-generate clients in any language.

llms-full.txt

Detailed reference with every endpoint's inputs, outputs, and examples — optimized for LLM context windows.

Quick start for agents

# 1. Discover what's available
curl https://meetmarkdown.com/llms.txt

# 2. Get the full API spec
curl https://meetmarkdown.com/.well-known/openapi.json

# 3. Call any endpoint
curl -X POST https://meetmarkdown.com/api/v1/format \
  -H "Content-Type: application/json" \
  -d '{"markdown":"# Hello\nworld"}'

Getting Started

Base URL: https://meetmarkdown.com/api/v1

All endpoints accept and return JSON. No authentication needed.

Maximum input size: 100KB. Rate limit: 60 requests per minute per IP.

CORS is enabled for all origins.

OpenAPI Specllms.txt

Endpoints

POST/api/v1/format

Format markdown with consistent spacing and aligned tables.

Example

curl -X POST https://meetmarkdown.com/api/v1/format \
  -H "Content-Type: application/json" \
  -d '{"markdown":"# Hello\nworld"}'
POST/api/v1/to-html

Convert markdown to semantic HTML with syntax highlighting.

Example

curl -X POST https://meetmarkdown.com/api/v1/to-html \
  -H "Content-Type: application/json" \
  -d '{"markdown":"# Hello\n**bold**"}'
POST/api/v1/html-to-markdown

Convert HTML to clean, readable markdown.

Example

curl -X POST https://meetmarkdown.com/api/v1/html-to-markdown \
  -H "Content-Type: application/json" \
  -d '{"html":"<h1>Hello</h1>"}'
POST/api/v1/word-count

Analyze markdown: word count, characters, reading time, headings, and more.

Example

curl -X POST https://meetmarkdown.com/api/v1/word-count \
  -H "Content-Type: application/json" \
  -d '{"markdown":"# Hello\nSome text here."}'
POST/api/v1/diff

Compare two markdown documents line by line.

Example

curl -X POST https://meetmarkdown.com/api/v1/diff \
  -H "Content-Type: application/json" \
  -d '{"original":"Hello","modified":"Hello world"}'
POST/api/v1/table-format

Format and align GFM markdown tables.

Example

curl -X POST https://meetmarkdown.com/api/v1/table-format \
  -H "Content-Type: application/json" \
  -d '{"markdown":"| A | B |\n|---|---|\n| 1 | 2 |"}'
Skill

Claude Code Skill

Use MeetMarkdown tools directly from Claude Code. Format markdown files, convert between formats, get word counts, and diff documents — all from your terminal.

Install

# Copy the skill to your project
mkdir -p .claude/skills
curl -s https://meetmarkdown.com/skills/meetmarkdown-tools/SKILL.md \
  -o .claude/skills/meetmarkdown-tools/SKILL.md --create-dirs

# Or install globally
curl -s https://meetmarkdown.com/skills/meetmarkdown-tools/SKILL.md \
  -o ~/.claude/skills/meetmarkdown-tools/SKILL.md --create-dirs

What you can do

"Format my README.md"

Consistent spacing, aligned tables, wrapped prose

"Convert this HTML to markdown"

Clean markdown from any HTML source

"How many words in docs/*.md?"

Word count, reading time, heading structure

"Diff README.md vs README.bak"

Line-by-line comparison with added/removed counts

Error Responses

StatusMeaning
400Missing or invalid input
413Input exceeds 100KB limit
429Rate limit exceeded (check Retry-After header)
500Internal server error