17 — Fortgeschrittenes Markdown
Kapitel 06 behandelt die Grundlagen. Dieses Kapitel sind die Zusätze, die dieser Server ebenfalls darstellt — jeder davon wurde auf dieser Installation ausprobiert.
Aufgabenlisten
- [x] Entwurf geschrieben
- [ ] wartet auf Review
Funktioniert in Issues und in .md-Dateien; die Kästchen sind nur zur Anzeige.
Emoji-Kurznamen
:tada: :rocket: :warning:
Wird zu 🎉 🚀 ⚠️. Emoji direkt einzufügen geht ebenso.
Fußnoten
Diese Aussage hat eine Quelle[^1]
[^1]: Woher die Aussage stammt.
Im Text erscheint eine hochgestellte Zahl, am Seitenende die verlinkte Anmerkung.
Mathematik
Inline $E = mc^2$ oder als Block:
```math
\frac{a}{b} = c
```
Formeln werden im Browser gesetzt; die Quelle bleibt Klartext, git diff also lesbar.
Diagramme
```mermaid
graph TD
A[Anfrage] --> B{Freigabe?}
B -- ja --> C[Mergen]
B -- nein --> D[Überarbeiten]
```
Fluss-, Sequenz- und Gantt-Diagramme entstehen aus Text. Weil keine Bilddatei nötig ist, liegt auch das Diagramm in der Versionshistorie — die Änderung sehen Sie im git diff.
Tabellen, Durchstreichen, Autolinks
| Spalte | Bedeutung |
|--------|-----------|
| `main` | Standard-Branch |
~~verworfen~~ und eine nackte Adresse: https://forge.kabaforce.com
Eine Adresse wird auch ohne Klammern zum Link.
Auf Issues und Personen verweisen
In Issues und Kommentarfeldern:
#12→ verlinkt dieses Issue@benutzer→ verlinkt die Person und benachrichtigt sieFixes #12in der Commit-Zusammenfassung → schließt das Issue, sobald die Änderung inmainist (Kapitel 11)
Wo was funktioniert
| Ort | Hinweis |
|---|---|
.md-Dateien | Alles; readme.md erscheint automatisch auf der Ordnerseite |
| Issues und Kommentare | Alles, dazu Dateien per Drag-and-drop als Anhang |
| Wiki-Seiten | Alles, mit eigener Historie (Kapitel 11) |
| Release-Notizen | Alles (Kapitel 12) |
Zwei Gewohnheiten
- Den Vorschau-Reiter nutzen — vor dem Commit sehen Sie genau das, was andere sehen.
- Ein Satz pro Zeile in langen Dokumenten — Unterschiede lesen sich zeilenweise, statt einen ganzen Absatz rot-grün zu färben.