Markdown Syntax
Markdown wurde mit den Grundgedanken konzipiert, so einfach lesbar und schreibbar wie möglich zu sein.
Lesbarkeit ist hierbei das oberste Ziel. Ein Markdown-formatiertes Dokument sollte in seiner Grundform veröffentlicht werden können, ohne den Anschein zu erwecken, es sei mit Tags oder Formatierungsbefehlen versehen (wie es bei HTML der Fall ist).
Dementsprechend besteht Markdowns Syntax nur aus Zeichen, die mit Bedacht so gewählt wurden, dass ihr Aussehen ihrer Bedeutung entspricht. Zum Beispiel sehen Sternchen um ein Wort tatsächlich wie eine Betonung aus. Listen in Markdown sehen aus wie Listen. Sogar Zitat-Blöcke sehen wie zitierte Textpassagen aus, wie man sie aus eMails kennt.
Überschriften
Kopfzeilen bzw. Überschriften werden in Markdown mit einer bis zu sechs Rauten-Zeichen definiert, je mehr Rauten-Zeichen verwendet werden, umso tiefer die Ebene der Überschrift.