DotMD
Comenta Markdownjusto en el pasaje.
Deja una nota en una frase, un párrafo o una fila de tabla de un archivo .md renderizado. No es ocultar texto con <!-- -->: un comentario queda unido a su pasaje y tu Markdown sigue limpio.
macOS 14 o posterior. Leer es gratis; DotMD Pro tiene 3 días de prueba gratuita.
Respuesta rápida
Selecciona texto en la página renderizada o en el editor y pulsa ⌥⌘M. El pasaje se marca en amarillo y el comentario queda unido a sus líneas. DotMD guarda los comentarios, no el archivo, así que tu Markdown sigue limpio. Envíaselos a un agente o guárdalos como notas para ti.
Cómo comentar un archivo Markdown
Un comentario es una nota sobre un pasaje: una frase, un párrafo, una fila de tabla o un elemento de lista. Es donde empieza toda revisión, y funciona sin ningún agente.
-
Selecciona el pasaje
Selecciona texto en la página renderizada o, si estás editando, en el editor.
-
Empieza el comentario
Haz clic en Comment junto a la selección, pulsa ⌥⌘M o elige Edit → Add Comment….
-
Escribe qué debe cambiar
Escribe tu nota y pulsa ⌘↩. El pasaje se pone amarillo en la página. Deja todos los comentarios que quieras antes de entregárselos a nadie.
El panel Review: Open, In Review, Resolved
El botón Review de la barra de herramientas abre a la derecha un panel con cada comentario del archivo como una tarjeta. La tarjeta muestra quién dejó el comentario, cuándo, en qué línea está y de qué pasaje trata. Haz clic en una tarjeta y la página se desplaza al pasaje.
| Sección | Qué contiene |
|---|---|
| Open | Comentarios de los que nadie se ha ocupado todavía |
| In Review | Comentarios que un agente dice haber corregido y esperan a que los aceptes o los reabras |
| Resolved | Hechos: aceptados o resueltos por ti |
Pasa el cursor por una tarjeta para ver sus botones: Expand, Edit, Resolve, Accept, Reopen y Delete. Resuelve tú mismo un comentario cuando no necesite ningún cambio.
Escribe comentarios con los que un agente pueda actuar
Escribe un comentario como si dieras instrucciones a un compañero: qué está mal y qué quieres en su lugar. Una nota precisa consigue una corrección precisa.
«Demasiado vago: nombra las tres métricas y sus umbrales».
Eso funciona mejor que «arregla esto». Cuando estés listo, el panel Review te da dos formas de entregar los comentarios. Si el agente te envió el archivo y espera, haz clic en Send. Si no, copia el prompt preparado con Copy y pégaselo a tu agente. La siguiente guía muestra cómo comprobar lo que hizo.
Comentarios de agentes
Los comentarios van en las dos direcciones. Pide a un agente que revise un archivo en DotMD y dejará sus observaciones en las líneas a las que se refieren, en lugar de responder en el chat. Aparecen en el mismo panel en Open, con el nombre del agente y su propio punto de color, así que distingues Claude Code de Codex de un vistazo. Puedes editarlos, borrarlos o resolverlos antes de que el autor vea nada. Un agente revisa a otro muestra todo el ciclo.
Dónde se guardan los comentarios
- En DotMD, no en el archivo. Tu Markdown no tiene marcas ni comentarios HTML, y otras apps ven el archivo tal como estaba.
- En su pasaje. Cuando se añaden líneas por encima, el número de línea del comentario se mueve con su texto.
- Con el archivo. Si lo renombras o lo mueves en DotMD, los comentarios se mueven con él. Si lo renombras o lo mueves en Finder o con
git mv, vuelven la primera vez que abres el archivo en su nuevo sitio. - Un mes después de que el archivo desaparezca. Los comentarios de un archivo borrado se eliminan aproximadamente un mes después, junto con su historial de versiones.
Preguntas sobre los comentarios en DotMD
¿Se guardan los comentarios en el archivo .md?
No. Los guarda DotMD, así que el archivo no tiene marcas ni comentarios HTML, y otras apps lo ven tal como estaba.
¿Puedo comentar sin un agente?
Sí, como notas para ti en un borrador.
¿Qué pasa si renombro o muevo el archivo?
Si lo renombras en DotMD, los comentarios se mueven con él. Si lo renombras en Finder o en git, vuelven la primera vez que abres el archivo en su nuevo sitio.
¿Necesito DotMD Pro para comentar?
Sí. Los comentarios y las revisiones forman parte de DotMD Pro: anual con 3 días de prueba gratis, o Lifetime. Leer es gratis.