DotMDCommenti in Markdowndirettamente sul passaggio.
<!-- commento --> nasconde il testo nella pagina Markdown renderizzata e lo lascia nel file. DotMD aggiunge commenti su una frase, un paragrafo o una riga di tabella che restano fuori dal file, così il tuo Markdown resta pulito.
macOS 14 o successivo. Leggere è gratis; modificare e revisionare si pagano una volta sola.
Risposta rapida
In Markdown un commento nel file è un commento HTML: <!-- note -->. Nel rendering resta invisibile, ma rimane nel file. Per commentare un passaggio senza toccare il file, selezionalo in DotMD e premi ⌥⌘M. Il commento resta legato alle sue righe e lo conserva DotMD, non il file. Invialo a un agente, o tienilo come nota per te.
Sintassi dei commenti in Markdown
Markdown non ha una sintassi propria per i commenti e usa quella di HTML. Tutto ciò che sta tra <!-- e --> è un commento, su una riga o su più righe:
<!-- A note to myself -->
<!--
A longer note
across several lines
-->
Text before <!-- an inline note --> and after.La pagina renderizzata omette il commento, ma questo resta nel file: chi apre il testo grezzo può leggerlo, quindi non metterci password o note private. Non scrivere -- dentro un commento. GitHub nasconde questi commenti allo stesso modo.
Come commentare un file Markdown
Un commento è una nota su un passaggio: una frase, un paragrafo, una riga di tabella o una voce di elenco. È da qui che parte ogni revisione, e funziona anche senza alcun agente.
-
Seleziona il passaggio
Seleziona il testo sulla pagina formattata o, se stai modificando, nell’editor.
-
Avvia il commento
Fai clic su Comment accanto alla selezione, premi ⌥⌘M oppure scegli Edit → Add Comment….
-
Scrivi cosa deve cambiare
Scrivi la tua nota e premi ⌘↩. Il passaggio diventa giallo sulla pagina. Lascia tutti i commenti che vuoi prima di consegnarli a qualcuno.
Il pannello Review: Open, In Review, Resolved
Il pulsante Review nella barra degli strumenti apre a destra un pannello con ogni commento del file come una scheda. La scheda mostra chi ha lasciato il commento, quando, a che riga si trova e a quale passaggio si riferisce. Fai clic su una scheda e la pagina scorre fino al passaggio.
| Sezione | Cosa contiene |
|---|---|
| Open | Commenti di cui nessuno si è ancora occupato |
| In Review | Commenti che un agente dice di aver corretto, in attesa che tu li accetti o li riapra |
| Resolved | Fatto: accettati, oppure risolti da te |
Passa sopra una scheda per vedere i suoi pulsanti: Expand, Edit, Resolve, Accept, Reopen e Delete. Risolvi tu stesso un commento quando non richiede alcuna modifica.
Scrivi commenti su cui un agente possa agire
Scrivi un commento come se dessi istruzioni a un collega: cosa non va e cosa vuoi al suo posto. Una nota precisa ottiene una correzione precisa.
«Troppo vago: nomina le tre metriche e le loro soglie.»
Funziona meglio di «sistema questo». Quando sei pronto, il pannello Review offre due modi per consegnare i commenti. Se l’agente ti ha mandato il file e aspetta, fai clic su Send. Altrimenti copia il prompt già pronto con Copy e incollalo al tuo agente. La guida successiva mostra come controllare cosa ha fatto.
Commenti degli agenti
I commenti vanno in entrambe le direzioni. Chiedi a un agente di rivedere un file in DotMD e lascerà le sue osservazioni sulle righe a cui si riferiscono, invece di rispondere nella chat. Compaiono nello stesso pannello sotto Open, con il nome dell’agente e un suo pallino colorato, così distingui Claude Code da Codex a colpo d’occhio. Puoi modificarli, eliminarli o risolverli prima che l’autore veda qualcosa. Un agente rivede un altro mostra tutto il ciclo.
Dove sono conservati i commenti
- In DotMD, non nel file. Il tuo Markdown non ha marcatori né commenti HTML, e le altre app vedono il file com’era.
- Sul loro passaggio. Quando si aggiungono righe sopra, il numero di riga del commento si sposta con il suo testo.
- Con il file. Rinominalo o spostalo in DotMD e i commenti lo seguono. Rinominalo o spostalo nel Finder o con
git mve tornano la prima volta che apri il file nella nuova posizione. - Un mese dopo la scomparsa del file. I commenti di un file eliminato vengono rimossi circa un mese dopo, insieme alla sua cronologia delle versioni.
Domande sui commenti in DotMD
I commenti vengono salvati nel file .md?
No. Li conserva DotMD, quindi il file non ha marcatori né commenti HTML, e le altre app lo vedono com’era.
Posso commentare senza un agente?
Sì, come note per te su una bozza.
Cosa succede se rinomino o sposto il file?
Se lo rinomini in DotMD, i commenti lo seguono. Se lo rinomini nel Finder o in git, tornano la prima volta che apri il file nella nuova posizione.
Mi serve DotMD Reviewer per commentare?
Sì. Commenti e revisioni fanno parte di DotMD Reviewer, $39.99 una volta. Leggere è gratis.