Agent-Skills.md

Agent Skills: Markdown Formatter

Format and structure content as clean, well-organized Markdown. Use when asked to create documentation, format text, or generate Markdown output.

UncategorizedID: beshkenadze/claude-skills-marketplace/markdown-formatter
1

Install this agent skill to your local

pnpm dlx add-skill https://github.com/beshkenadze/claude-skills-marketplace/tree/HEAD/skills/creative/markdown-formatter

Skill Files

Browse the full folder contents for markdown-formatter.

Download Skill

Loading file tree…

skills/creative/markdown-formatter/SKILL.md

Skill Metadata

Name
markdown-formatter
Description
Format and structure content as clean, well-organized Markdown. Use when asked to create documentation, format text, or generate Markdown output.

Markdown Formatter

Overview

Transforms unstructured content into clean, well-organized Markdown with proper headings, lists, code blocks, and formatting.

Instructions

When formatting content to Markdown:

  1. Analyze the content to identify structure (headings, lists, code, etc.)
  2. Apply hierarchy using appropriate heading levels (H1 for title, H2 for sections)
  3. Format code with proper language-specific syntax highlighting
  4. Create lists for related items (bullet for unordered, numbers for sequential)
  5. Add tables for structured data comparisons

Formatting Rules

Headings

  • H1 (#) - Document title only
  • H2 (##) - Major sections
  • H3 (###) - Subsections
  • H4+ - Avoid unless necessary

Code Blocks

  • Inline code: Single backticks for short references
  • Fenced blocks: Triple backticks with language identifier

Lists

  • Bullet lists: Related but unordered items
  • Numbered lists: Sequential steps or ranked items
  • Nested lists: Maximum 2 levels deep

Examples

Example: Format API Documentation

Input: "Document the getUser function that takes userId string and returns User object with name email and createdAt fields"

Output:

## `getUser(userId)`

Retrieves a user by their unique identifier.

### Parameters

| Name | Type | Description |
|------|------|-------------|
| `userId` | `string` | The unique user identifier |

### Returns

`User` object with the following properties:

- `name` - User's display name
- `email` - User's email address
- `createdAt` - Account creation timestamp

Guidelines

Do

  • Keep line length under 100 characters
  • Use blank lines to separate sections
  • Prefer ATX-style headings (#) over Setext
  • Use reference-style links for repeated URLs
  • Include language identifier in fenced code blocks

Don't

  • Use more than 3 heading levels unless necessary
  • Mix heading styles in same document
  • Create deeply nested lists (max 2 levels)
  • Use HTML tags when Markdown suffices