AI Agents
Build your own coding agent — the same way Cursor does it
CLAUDE.md, .cursorrules, subfolder rules — here's what goes in them and
how to scope rules to where they matter.
Start here
Fundamentals
Plain text formatted — what "AI-ready" really means
Why structured plain text is the most reliable format for both writing
prompts and receiving AI output — and what gets lost when you skip it.
Read article →
Fundamentals
What is Markdown? A plain-language introduction
Plain text with meaning — what the symbols do, why it became the default format
of the web, and why AI speaks it natively.
Read article →
Guide
Write in the language of AI
Markdown is the format AI tools read best. A practical guide to the
syntax that matters — and why each element makes your AI interactions sharper.
Read article →
New — AI Agents series
AI Agents — Part 1
Build your own agent with markdown — no code required
Cursor and Claude Code aren't magic — they're a system prompt and some markdown files.
You can build the same thing for your own work, right now.
Read article →
AI Agents — Part 2
Build your own coding agent — the same way Cursor does it
CLAUDE.md, .cursorrules, subfolder rules — what goes in them and how to
scope rules to where they matter.
Read article →
The tools
Ready to put it to work?
Markdown × AI
Where markdown meets machine thinking
AI Agents
Build your own agent with markdown — no code required
Cursor and Claude Code aren't magic — they're a system prompt and some
markdown files. You can build the same thing for your own work, right now.
Guide
Write in the language of AI
Markdown is the format AI tools read best. The syntax that matters —
and why each element makes your AI interactions sharper.
Opinion
How AI Interfaces Break the Format They Run On
Every major AI chat interface is built on markdown — and every one
of them systematically works against it.
AI workflow
Copy button vs. selection — why they give you different text
The copy button and Ctrl+C don't give you the same thing. Here's why — and what to do about it.
AI workflow
Markdown as RAG — your own lightweight context layer
You don't need a vector database to give an AI agent meaningful background knowledge.
A plain Markdown file is faster, more readable, and easier to maintain.
AI workflow
Jupyter notebooks and markdown — AI-native by design
Jupyter's .ipynb format embeds markdown natively. What that means for
AI-generated notebooks and why it matters.
AI workflow
Spec-driven development — this is where Markdown really shines
Write the spec first, in Markdown. Then hand it to AI. Cleaner output,
fewer correction cycles, and a document that stays useful long after the first session.
AI workflow
Spec-driven development: the full workflow
Phases, slices, and what happens to documentation after launch —
plus three ready-to-use prompts for spec-driven projects.
Syntax & features
What markdown can do
Syntax
Mermaid diagrams — the format AI actually draws in
When you ask an AI to draw a diagram, it almost always writes Mermaid syntax.
Here's what Mermaid is, why AI converged on it, and how to render what you get.
Syntax
Syntax highlighting in markdown — how it works and why it matters
Fenced code blocks, language tags, and why the same markdown renders so
differently depending on where you put it.
Syntax
Math in markdown — LaTeX, KaTeX, and AI-generated equations
AI writes math with LaTeX syntax. Here's what that means, where it renders,
and how to get clean output in your documents.
The basics
Start here if you're new to markdown
Fundamentals
What is Markdown? A plain-language introduction
Plain text with meaning — what the symbols do, why it became the default
format of the web, and why AI speaks it natively.
Fundamentals
Plain text formatted — what "AI-ready" really means
Why structured plain text is the most reliable format for both writing
prompts and receiving AI output.