ASCII-Überschriften lassen eine README hervorstechen
Eine schlichte README beginnt mit einer Textzeile. Eine großartige beginnt mit einem Banner. ASCII-Art gibt deinem Projekt eine wiedererkennbare Überschrift, Abschnittstrenner und Status-Badges, ohne Bilddateien ins Repository zu legen — es ist nur Text, lädt also sofort und funktioniert in jedem Git-Viewer.
Nutze immer einen Codeblock
GitHubs Markdown zeigt normalen Text proportional, was die ASCII-Ausrichtung zerstört. Packe die Kunst in einen Codeblock, damit sie in Monospace dargestellt wird:
```__ __ _ _ _ _ ___| \/ | | | | | | | / __|| |\/| | |_| | |_| \__ \|_| |_|\__, |\___/|___/|___/```
Nutze einen Block mit drei Backticks ohne Sprach-Tag, damit kein Syntax-Highlighter deine Kunst umfärbt.
Wähle die richtige Breite
READMEs werden auf breiten Desktop-Bildschirmen gelesen, aber auch in schmalen Mobil-Vorschauen und in GitHubs Dateiliste. Ziele auf 80-100 Zeichen: breit genug für eine selbstbewusste Überschrift, schmal genug, dass es am Handy nicht seitlich scrollt. Für Unterabschnitt-Trenner ist kürzer besser.
Wo du es einsetzt
- Das Projekt-Titelbanner ganz oben.
- Abschnittstrenner über Installation, Nutzung und Lizenz.
- Einfache Statusmarker wie
== BUILD PASSING ==. - Ein ASCII-Logo aus deinem App-Icon erzeugt.
Halte es barrierefrei
Screenreader lesen ASCII-Art Zeichen für Zeichen, verstecke also keine wichtigen Infos in der Kunst. Behalte eine normale Textüberschrift neben dem Banner, damit die Seite auch ohne Sinn ergibt.