Guides
Guides to Markdown files
Plain-English explanations for people who have started receiving .md files, often from coding agents, and want to read and edit them with confidence. No prior knowledge of Markdown assumed.
What is a Markdown file, and how do I open one on Windows?
A .md file is plain text with a few simple formatting marks. Learn what Markdown is, why so many tools and coding agents use it, and the ways to open and read a .md file on Windows.
Reading the Markdown that coding agents write
Coding agents such as Claude Code, Codex and Copilot leave plans, reports, checklists and instruction files as .md files in your project. What they are, how to read them comfortably, and how to edit them without breaking the agent's workflow.
Markdown tables explained
How to write a table in Markdown, align columns, escape pipes, and fix the mistakes that stop a table rendering. Plus what to do with the very wide tables coding agents produce.
Mermaid diagrams in Markdown
Mermaid turns a few lines of text in a Markdown file into a flowchart or sequence diagram. What a Mermaid block looks like, where it renders, why coding agents use it, and how to fix one that will not draw.