Article
Markdown meistern: Der GitHub-Guide für Einsteiger
Was ist Markdown und warum ist es wichtig?
Markdown ist eine leichtgewichtige Auszeichnungssprache für Klartext. Auf GitHub kannst du Markdown in READMEs, Issues, Pull Requests und Kommentaren verwenden. Die Syntax ist einfach zu erlernen und macht Dokumentation klar und lesbar.
Die Grundlagen sind schnell gemeistert: Überschriften mit #, fett mit **text**, kursiv mit *text*. Aufzählungen mit - oder *, nummerierte Listen mit 1.. Links mit [Text](URL) und Bilder mit . Codeblöcke mit drei Backticks.
Praktisch arbeiten mit Markdown
Öffne ein Repository auf GitHub, klicke auf “Add file” und wähle “Create new file”. Benenne die Datei mit .md am Ende. Du kannst zwischen Edit und Preview wechseln, um deine Formatierung zu überprüfen.
Für Zitate nutzt du > am Zeilenanfang. Verschachtelte Listen entstehen durch Einrücken mit 4 Leerzeichen. Code inline wird mit einzelnen Backticks formatiert, Codeblöcke mit drei Backticks und optionaler Sprachangabe.
Fortgeschrittene Techniken
Markdown geht über GitHub hinaus: Moderne Notiz-Apps, Blog-Plattformen und Dokumentationstools nutzen die gleiche Syntax. Es ist eine universelle Fähigkeit, die du in fast jedem Tech-Projekt einsetzen kannst.
Übungsbeispiel: Erstelle eine README für dein nächstes Projekt mit Überschrift, Einleitung, einer Liste von Features und einem Installations-Codeblock. Das ist der beste Weg, um Markdown zu verinnerlichen.