---
title: Why I write in markdown
date: 2026-08-10
tags: [writing, tools]
summary: Markdown keeps the writing simple and the files portable. Here is why I choose it for every post.
---
I write every post in markdown. Markdown is plain text with a few simple
rules for structure. It is easy to read, easy to edit, and easy to move
between tools.
## The rules I use
- Headings start with `#`.
- Lists start with `-` or `1.`.
- Links use `[text](url)`.
- Code uses backticks.
That is almost all I need. The rest is just words.
## Why not a rich editor
A rich editor hides the structure of the text. Markdown keeps the structure
visible. When the structure is visible, the writing stays honest.
## Portability
A markdown file is a text file. It works with any editor, any operating
system, and any version control tool. It will still be readable in twenty
years.
| Editor | Write the text |
| Git | Track the changes |
| Generator | Build the site |
| Nginx | Serve the files |