On Writing in Markdown
Markdown is the format that gets out of your way. It reads cleanly as plain source, it diffs nicely in git, and it will still open in any text editor twenty years from now.
Tables work too
| Feature | Supported |
|---|---|
| Tables | Yes |
| Footnotes | Yes |
| Code | Yes |
Write it once, and you can render it anywhere.
Shorthand explains itself
Jargon is fine as long as the reader can check it. Define an abbreviation once and every mention of it carries the long form, so a post can say YAML (YAML Ain't Markup Language) or SSG (Static Site Generator) without stopping to spell either one out.