Blog

Practical guides to writing in Markdown. The techniques work in any Markdown editor and on GitHub; where Markpion has a shortcut for something, the article mentions it.

What Is Markdown? A Practical Introduction

2026-09-25: what Markdown is, why developers and writers use it, the syntax you need on day one, and the different flavours.

Markdown Tables: The Complete Guide

2026-09-25: table syntax, alignment, escaping, what tables can't do, and how to keep them tidy.

How to Create Mermaid Diagrams in Markdown

2026-09-25: flowcharts, sequence diagrams and Gantt charts as text, with examples you can paste.

How to Write a Great README

2026-09-25: the sections a README needs, in the order readers look for them, with a template.