Skip to content
agent-md

agent-md

Fast Markdown editor, linter, and formatter designed for AI agents and LLM pipelines. Save tokens, speed up inference, and reduce costs.
Getting StartedCLI Usage GuideVS Code Extension

Why agent-md?

Section titled “Why agent-md?”

Modern software development increasingly relies on LLMs and autonomous AI agents reading, writing, and modifying Markdown documentation. However, conventional Markdown is designed for human visual comfort—packed with decorative characters, padded tables, bold markers, and ASCII art trees that inflate prompt sizes and waste context tokens.

agent-md introduces an AI-first Markdown standard with zero-overhead tooling.

Token Optimization

Reduces up to 20% of unnecessary tokens across tables, lists, comments, and directory trees without losing information density.

AI Agent First

Designed for autonomous tool execution: structured JSON output, section-level read/write operations, and pre-validation.

Hardware Accelerated

Written in pure Rust with SIMD vectorization (ARM NEON & AVX2/SSE2) and zero runtime dependencies for lightning-fast parsing.

Extensible Ecosystem

Includes official VS Code/Cursor/Devin extension, standalone CLI, Cargo crate library, and Homebrew tap.

Token Efficiency in Action

Section titled “Token Efficiency in Action”

See how agent-md compacts standard Markdown elements into clean, dense, LLM-friendly structures:

| Function | Arguments | Return Type | Description                   |
|----------|-----------|-------------|-------------------------------|
| `add()`  | a, b      | i32         | Adds two numbers              |
| `sub()`  | a, b      | i32         | Subtracts numbers             |
|---|---|---|---|
| `add()` | a, b | i32 | Adds two numbers |
| `sub()` | a, b | i32 | Subtracts numbers |

Quick Installation

Section titled “Quick Installation”
Terminal window
brew tap loclv/tools
brew install agent-md

Explore Documentation

Section titled “Explore Documentation”
CLI Usage GuideLearn all CLI subcommands: read, write, write-section, fmt, lint, and stats.
LLM & Agent IntegrationRules and best practices for incorporating agent-md into AI agent loops.
Markdown Writing RulesComplete guide to AI-friendly Markdown syntax: no-bold, simple tables, and code blocks.
Configuration & OverridesConfigure .agent-md.json, overrides, and markdownlintrc compatibility.