Kommentar in Markdown,direkt an der Stelle.

Kommentar-Syntax in Markdown

Markdown hat keine eigene Kommentar-Syntax und übernimmt die von HTML. Alles zwischen <!-- und --> ist ein Kommentar, in einer Zeile oder über mehrere:

<!-- A note to myself -->

<!--
A longer note
across several lines
-->

Text before <!-- an inline note --> and after.

Die gerenderte Seite lässt den Kommentar weg, in der Datei bleibt er aber stehen: Wer den Rohtext öffnet, kann ihn lesen, also gehören keine Passwörter oder privaten Notizen hinein. Schreibe kein -- in einen Kommentar. GitHub blendet solche Kommentare genauso aus.

So kommentierst du eine Markdown-Datei

Ein Kommentar ist eine Notiz zu einer Stelle: einem Satz, einem Absatz, einer Tabellenzeile oder einem Listenpunkt. Mit ihm beginnt jedes Review, und er funktioniert auch ganz ohne Agenten.

1. Wähle die Stelle aus

   Markiere Text auf der gerenderten Seite oder, wenn du gerade bearbeitest, im Editor.

2. Beginne den Kommentar

   Klicke neben der Markierung auf Comment, drücke ⌥⌘M oder wähle Edit → Add Comment….

3. Schreib, was sich ändern soll

   Tippe deine Notiz und drücke ⌘↩. Die Stelle wird auf der Seite gelb. Du kannst so viele Kommentare schreiben, wie du willst, bevor du sie jemandem übergibst.

Der Review-Bereich: Open, In Review, Resolved

Die Taste Review in der Symbolleiste öffnet rechts einen Bereich, in dem jeder Kommentar zur Datei als Karte steht. Eine Karte zeigt, wer den Kommentar geschrieben hat, wann, in welcher Zeile er steht und zu welcher Stelle er gehört. Klickst du auf eine Karte, scrollt die Seite zur Stelle.

Fahre über eine Karte, dann erscheinen ihre Tasten: Expand, Edit, Resolve, Accept, Reopen und Delete. Markiere einen Kommentar selbst als erledigt, wenn er keine Änderung braucht.

Kommentare schreiben, mit denen ein Agent arbeiten kann

Schreib einen Kommentar so, wie du eine Kollegin oder einen Kollegen briefen würdest: was falsch ist und was du stattdessen willst. Eine genaue Notiz bringt eine genaue Korrektur.

„Zu vage: Nenne die drei Kennzahlen und ihre Schwellenwerte.“

Das funktioniert besser als „Mach das besser“. Wenn du so weit bist, bietet der Review-Bereich zwei Wege, die Kommentare zu übergeben. Hat dir der Agent die Datei geschickt und wartet, klicke auf Send. Sonst kopiere den fertigen Prompt mit Copy und gib ihn deinem Agenten. Die nächste Anleitung zeigt, wie du prüfst, was er getan hat.

Kommentare von Agenten

Kommentare gehen in beide Richtungen. Bitte einen Agenten, eine Datei in DotMD zu prüfen, und er hinterlässt seine Anmerkungen an den Zeilen, um die es geht, statt im Chat zu antworten. Sie erscheinen im selben Bereich unter Open, mit dem Namen des Agenten und seinem eigenen farbigen Punkt, sodass du Claude Code und Codex auf einen Blick auseinanderhältst. Du kannst sie bearbeiten, löschen oder erledigen, bevor der Autor etwas sieht. Ein Agent prüft den anderen zeigt den ganzen Ablauf.

Wo Kommentare gespeichert sind

• In DotMD, nicht in der Datei. Dein Markdown enthält keine Markierungen und keine HTML-Kommentare, und andere Apps sehen die Datei wie vorher.
• An ihrer Stelle. Wenn darüber Zeilen hinzukommen, wandert die Zeilennummer des Kommentars mit seinem Text.
• Mit der Datei. Benennst du sie in DotMD um oder verschiebst sie, ziehen die Kommentare mit. Benennst du sie im Finder oder mit git mv um oder verschiebst sie, sind sie beim ersten Öffnen der Datei am neuen Ort wieder da.
• Einen Monat, nachdem die Datei weg ist. Die Kommentare einer gelöschten Datei werden etwa einen Monat später entfernt, zusammen mit ihrem Versionsverlauf.

Fragen zu Kommentaren in DotMD

Weitere Fragen