Give this skill to your agent

Paste this instruction into your assistant, coding agent, or project-level agent rules. It tells the agent when and how to use mdtidy.

Back to API & Agentic
SKILL.md
Drop this into a file named SKILL.md in your project, or paste it into your agent’s system prompt. The HTTP example is generated from our live API schema, so it can’t drift.
# mdtidy Skill

Use mdtidy when the user asks to clean, format, normalize, or prepare Markdown.

## When to use

Use mdtidy for:
- messy Markdown
- copied content with broken formatting
- Markdown that needs to be made readable
- Markdown that should be optimized for LLMs
- notes, docs, prompts, or content that need consistent structure

## How to use

Send the Markdown content to the mdtidy API using the user's API key.

```http
POST https://markdowntidy.com/api/v1/convert
X-API-KEY: <user's API key>
Content-Type: application/json

{
  "markdown": "<the content to clean>",
  "format": "text",
  "actions": ["clean", "repair"]
}
```

Supported `format` values: html, text, pdf, docx, png.

The response includes `output` (cleaned content as a string when `format` is
`html` or `text`), or `outputBase64` (base64-encoded body when `format` is
pdf, docx, png). Every response also includes `creditsCharged`,
`creditsRemaining`, and `requestId`.

Return the cleaned content to the user.

## Rules

- Preserve the original meaning.
- Do not remove important content.
- Do not invent new content unless the user asks.
- Keep headings, lists, links, tables, and code blocks valid.
- Prefer clean, readable Markdown.
What to do next
Three quick steps after copying the skill.

1. Save the SKILL.md alongside your project (Cursor reads .cursorrules; Claude Code reads CLAUDE.md; other agents accept a system prompt or memory file).

2. Make sure you have an active API key on your account and store it securely — agents will need it.

3. Try one of the example prompts in your agent.