DotMD
Comente Markdownmesmo na passagem.
Deixe uma nota numa frase, num parágrafo ou numa linha de tabela de um ficheiro .md formatado. Não é esconder texto com <!-- -->: um comentário fica ligado à sua passagem e o seu Markdown continua limpo.
macOS 14 ou posterior. Ler é grátis; o DotMD Pro tem 3 dias de teste gratuito.
Resposta rápida
Selecione texto na página formatada ou no editor e prima ⌥⌘M. A passagem fica marcada a amarelo e o comentário fica ligado às suas linhas. Os comentários são guardados pelo DotMD, não pelo ficheiro, por isso o seu Markdown continua limpo. Envie-os a um agente ou guarde-os como notas para si.
Como comentar um ficheiro Markdown
Um comentário é uma nota sobre uma passagem: uma frase, um parágrafo, uma linha de tabela ou um item de lista. É por aqui que começa qualquer revisão, e funciona sem qualquer agente.
-
Selecione a passagem
Selecione texto na página formatada ou, se estiver a editar, no editor.
-
Comece o comentário
Clique em Comment junto à seleção, prima ⌥⌘M ou escolha Edit → Add Comment….
-
Escreva o que deve mudar
Escreva a sua nota e prima ⌘↩. A passagem fica amarela na página. Deixe quantos comentários quiser antes de os entregar a alguém.
O painel Review: Open, In Review, Resolved
O botão Review da barra de ferramentas abre à direita um painel com cada comentário do ficheiro como um cartão. O cartão mostra quem deixou o comentário, quando, em que linha está e a que passagem se refere. Clique num cartão e a página desloca-se até à passagem.
| Secção | O que contém |
|---|---|
| Open | Comentários de que ninguém tratou ainda |
| In Review | Comentários que um agente diz ter corrigido e que esperam que os aceite ou reabra |
| Resolved | Concluído: aceite, ou resolvido por si |
Passe o cursor por um cartão para ver os seus botões: Expand, Edit, Resolve, Accept, Reopen e Delete. Resolva você mesmo um comentário que não exija alterações.
Escreva comentários com que um agente possa trabalhar
Escreva um comentário como se estivesse a instruir um colega: o que está errado e o que quer em vez disso. Uma nota precisa dá uma correção precisa.
«Demasiado vago: indique as três métricas e os respetivos limites.»
Isso funciona melhor do que «corrige isto». Quando estiver pronto, o painel Review oferece duas formas de entregar os comentários. Se o agente lhe enviou o ficheiro e espera, clique em Send. Caso contrário, copie o prompt pronto com Copy e cole-o no seu agente. O guia seguinte mostra como verificar o que ele fez.
Comentários de agentes
Os comentários vão nos dois sentidos. Peça a um agente que reveja um ficheiro no DotMD e ele deixa as observações nas linhas a que dizem respeito, em vez de responder no chat. Aparecem no mesmo painel em Open, com o nome do agente e o seu próprio ponto colorido, para distinguir o Claude Code do Codex num relance. Pode editá-los, apagá-los ou resolvê-los antes de o autor ver o que quer que seja. Um agente revê outro mostra o ciclo completo.
Onde ficam guardados os comentários
- No DotMD, não no ficheiro. O seu Markdown não tem marcas nem comentários HTML, e as outras apps veem o ficheiro como estava.
- Na sua passagem. Quando se juntam linhas por cima, o número da linha do comentário desloca-se com o seu texto.
- Com o ficheiro. Mude-lhe o nome ou mova-o no DotMD e os comentários vão com ele. Mude-lhe o nome ou mova-o no Finder ou com
git mve voltam na primeira vez que abrir o ficheiro no novo local. - Um mês depois de o ficheiro desaparecer. Os comentários de um ficheiro apagado são removidos cerca de um mês depois, juntamente com o seu histórico de versões.
Perguntas sobre os comentários no DotMD
Os comentários ficam guardados no ficheiro .md?
Não. O DotMD guarda-os, por isso o ficheiro não tem marcas nem comentários HTML, e as outras apps veem-no como estava.
Posso comentar sem um agente?
Sim, como notas para si num rascunho.
O que acontece se mudar o nome ou mover o ficheiro?
Se mudar o nome no DotMD, os comentários vão com ele. Se o mudar no Finder ou no git, voltam na primeira vez que abrir o ficheiro no novo local.
Preciso do DotMD Pro para comentar?
Sim. Os comentários e as revisões fazem parte do DotMD Pro: anual com 3 dias de teste gratuito, ou Lifetime. Ler é gratuito.