DotMDBlog.Markdown, one question at a time.
Short articles that answer one Markdown question each, with code you can copy and a note on how it looks when rendered.
macOS 14 or later. Reading is free; editing and reviews are one payment.
Quick answer
This is where DotMD answers the small questions about Markdown: how to make a table, a code block or a collapsible section, and how to write a PRD or review an AI spec. Each article gives the syntax first, then the details and the mistakes people make. For the app itself, see the guides.
Latest articles
Newest first.
AI spec review checklist
A checklist for reviewing an AI-written spec or plan: scope, edge cases, data, tests and rollback.
PRD template
A PRD template in Markdown to copy, with numbered requirements an AI agent can build from.
CLAUDE.md vs AGENTS.md
Which agent reads CLAUDE.md and which reads AGENTS.md, and how to keep one set of instructions.
Mermaid flowcharts
Mermaid flowchart syntax: directions, node shapes, links, subgraphs and the mistakes that break a diagram.
Images
The image syntax, relative paths, and how to set a size, center an image or add a caption.
Code blocks
Fenced code blocks, language tags for syntax highlighting, nested backticks, inline code and diffs.
Collapsible sections
A dropdown section with the details and summary tags, and the blank line rule inside it.
Markdown line breaks
Why Markdown joins your lines, and the three ways to break one: two spaces, a backslash or a br tag.
Markdown task lists
Write checkboxes with - [ ] and - [x], nest them, and see where they render.
Markdown tables
The table syntax, column alignment, a pipe or a second line inside a cell, and wide tables.
Questions about the blog
What is on the DotMD blog?
Short how-to articles about Markdown syntax: tables, task lists, line breaks and more. Each one has examples you can copy.
Which Markdown flavour do the articles use?
CommonMark and GitHub Flavored Markdown, the dialect GitHub and most Markdown apps follow. Where an app differs, the article says so.
Where can I see these examples rendered?
Open the file in a Markdown reader. DotMD for Mac shows tables, task lists and line breaks rendered, and reading is free. See Reading Markdown.