# `agent-md` - A CLI tool that helps you write markdown friendly for LLM

```bash

agent-md lint README.md

```

## Why this tool exists

Many markdown files today are written by LLMs or AI agents, wasting a lot of tokens. When another LLM reads these files, it continues to consume unnecessary tokens.

The reason is that markdown is designed for human readability, often containing elements like bold text, decorative characters, whitespace... These things are useful for humans but unnecessary for LLMs.

In fact, LLMs/agents do not need to read the entire file. They only need to access the specific parts of the content they require (for example: ## Development) instead of processing the entire document.

## Problems

- Token waste: Formats like bold, tables, and decorative characters increase the number of tokens without assisting the AI

- Inefficient reading: LLM still has to process presentation elements like *bold*, ASCII art…

- Redundant structure: Many components are only useful for humans (complex tables, nice layouts) but not needed for AI

- Increased costs: Each time an LLM reads the document, it has to “pay” for these formatting parts

## Solution

agent-md proposes a minimalist, AI-friendly markdown writing approach that helps:

- Reduce unnecessary tokens

- Keep content clear and easily accessible by sections

- Ensure it remains readable for humans when needed

The goal is: to write once, optimized for both humans and AI, without wasting resources.