Skip to content
TakoAPI
Back to skills

markdown-formatter

by michael-laffin

PDF & Documents
4.3kDownloads reported by clawskills.sh
3Stars
1Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Format and beautify markdown documents.

Description

What This Skill Does

Formats, lints, and beautifies markdown documents using configurable style guides including CommonMark, GitHub Flavored Markdown, and custom rules. Handles heading normalization, list consistency, line wrapping, whitespace cleanup, and link validation. Supports single-file and batch processing.

Handles batch processing and style-guide enforcement in one pass, replacing the need to manually run separate linters and formatters.

When to Use It

  • Normalizing heading styles across a project's README files
  • Cleaning up markdown output from LLMs before publishing
  • Batch-formatting docs before a documentation site deployment
  • Linting API spec markdown for consistency before code review
  • Reformatting blog posts to match a house style guide

Example Workflow

INPUT

User asks: format this markdown file to GitHub style with 80-char line wrap

AGENT
  1. 1

    Receives markdown content or file path from user

  2. 2

    Calls formatMarkdown with style set to 'github' and maxWidth 80

  3. 3

    Checks returned warnings array for any issues

  4. 4

    Returns formattedMarkdown to user along with stats on changes made

OUTPUT

Formatted markdown string with normalized headings, consistent list markers, fenced code blocks, and lines wrapped at 80 characters

Installation

clawhub install michael-laffin/markdown-formatter

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links