Praxisnotizen
Dokumentation erstellen, die leicht prüfbar und wartbar ist.
Aufgabenorientierte Anleitungen mit kopierbaren Beispielen, klaren Grenzen und Verweisen auf die Browser-Tools.
Markdown-Tabellen
04 AnleitungenANLEITUNG 01
CSV in eine Markdown-Tabelle umwandeln, ohne Anführungszeichen zu beschädigen
Ein praktischer CSV-zu-Markdown-Ablauf für Kommas in Anführungszeichen, maskierte Zeichen, Ausrichtung und Zielprüfung.
Anleitung lesenANLEITUNG 02
Markdown-Tabellen ausrichten: links, zentriert und rechts
So steuern Doppelpunkte in der Trennzeile die Ausrichtung und so wählen Sie die passende Form.
Anleitung lesenANLEITUNG 03
Pipes und Zeilenumbrüche in Markdown-Tabellenzellen maskieren
Verhindern Sie fehlerhafte Spalten durch korrekten Umgang mit Pipes, Backslashes, HTML-Umbrüchen und Renderer-Unterschieden.
Anleitung lesenANLEITUNG 04
Bessere Tabellen für GitHub-README-Dateien gestalten
Ein gut prüfbarer Ablauf für kompakte README-Tabellen mit Überschriften, Ausrichtung, Links, Badges und mobiler Lesbarkeit.
Anleitung lesenMermaid-Diagramme
04 AnleitungenANLEITUNG 05
Mermaid-Flussdiagramme: Knoten, Entscheidungen, Beschriftung und Richtung
Lesbare Flussdiagramme mit stabilen IDs, eindeutiger Richtung, beschrifteten Zweigen, Subgraphen und Syntaxprüfungen.
Anleitung lesenANLEITUNG 06
Mermaid-Sequenzdiagramme für API- und Serviceaufrufe
API-Anfragen, Antworten, Schleifen, Alternativen und Fehler in lesbaren Mermaid-Sequenzdiagrammen modellieren.
Anleitung lesenANLEITUNG 07
Mermaid-ER-Diagramme für Datenbankbeziehungen
Entitäten, Attribute, Primär- und Fremdschlüssel sowie Kardinalitäten mit Mermaid-ER-Diagrammen dokumentieren.
Anleitung lesenANLEITUNG 08
Mermaid-Gantt-Diagramme für schlanke Projektpläne
Wartbare Gantt-Diagramme mit eindeutigen Daten, Aufgaben-IDs, Abhängigkeiten, Meilensteinen und ehrlichen Grenzen.
Anleitung lesenDokumentations-Workflow
02 AnleitungenANLEITUNG 09
Mermaid-Syntaxfehler systematisch debuggen
Ein wiederholbarer Prozess zum Eingrenzen von Parserfehlern bei Diagrammtypen, reservierten Wörtern, Blöcken und Versionen.
Anleitung lesenANLEITUNG 10
Ein prüfbarer Diagram-as-Code-Workflow für Entwicklungsteams
Mermaid-Diagramme durch klare Verantwortung, Quelle der Wahrheit, PR-Prüfungen und Aktualisierungsauslöser nützlich halten.
Anleitung lesen