DotMD
Коментуйте Markdownпросто на потрібному місці.
Залиште нотатку до речення, абзацу чи рядка таблиці у відрендереному .md-файлі. Це не приховування тексту через <!-- -->: коментар лишається прив’язаним до свого уривка, а ваш Markdown лишається чистим.
macOS 14 або новіша. Читати можна безкоштовно; DotMD Pro має 3-денний безкоштовний пробний період.
Коротко
Виділіть текст на відрендереній сторінці або в редакторі й натисніть ⌥⌘M. Уривок підсвітиться жовтим, а коментар залишиться прив’язаним до його рядків. Коментарі зберігає DotMD, а не файл, тож ваш Markdown лишається чистим. Надішліть їх агентові або залиште як нотатки для себе.
Як залишити коментар до Markdown-файлу
Коментар — це нотатка до уривка: речення, абзацу, рядка таблиці чи пункту списку. З нього починається кожне рев’ю, і він працює навіть без агента.
-
Виділіть уривок
Виділіть текст на відрендереній сторінці або, якщо редагуєте, в редакторі.
-
Почніть коментар
Натисніть Comment поруч із виділенням, натисніть ⌥⌘M або виберіть Edit → Add Comment….
-
Напишіть, що треба змінити
Введіть нотатку й натисніть ⌘↩. Уривок на сторінці стане жовтим. Залиште стільки коментарів, скільки потрібно, перш ніж комусь їх передавати.
Панель Review: Open, In Review, Resolved
Кнопка Review на панелі інструментів відкриває праворуч панель, де кожен коментар до файлу показано карткою. На картці видно, хто залишив коментар, коли, на якому він рядку й до якого уривка належить. Натисніть картку, і сторінка прокрутиться до уривка.
| Розділ | Що в ньому |
|---|---|
| Open | Коментарі, якими ще ніхто не займався |
| In Review | Коментарі, які агент вважає виправленими й які чекають, поки ви їх приймете або відкриєте знову |
| Resolved | Готово: прийняті або закриті вами |
Наведіть курсор на картку, і з’являться її кнопки: Expand, Edit, Resolve, Accept, Reopen і Delete. Коментар, якому не потрібні зміни, закрийте самі.
Пишіть коментарі, за якими агент може діяти
Пишіть коментар так, як ставили б завдання колезі: що не так і що ви хочете натомість. Точна нотатка дає точне виправлення.
«Надто розпливчасто: назвіть три метрики та їхні пороги».
Це працює краще, ніж «виправ це». Коли будете готові, у панелі Review є два способи передати коментарі. Якщо агент надіслав вам файл і чекає, натисніть Send. Якщо ні, скопіюйте готовий промпт кнопкою Copy і вставте його агентові. У наступному посібнику показано, як перевірити, що він зробив.
Коментарі від агентів
Коментарі працюють в обидва боки. Попросіть агента перевірити файл у DotMD, і він залишить зауваження на тих рядках, яких вони стосуються, замість відповіді в чаті. Вони з’являться в тій самій панелі в розділі Open, з ім’ям агента та його власною кольоровою цяткою, тож Claude Code і Codex розрізняються з першого погляду. Ви можете редагувати, видаляти чи закривати їх, поки автор нічого не побачив. Один агент перевіряє іншого показує весь цикл.
Де зберігаються коментарі
- У DotMD, а не у файлі. У вашому Markdown немає ні маркерів, ні HTML-коментарів, і інші застосунки бачать файл таким, яким він був.
- На своєму уривку. Коли вище додаються рядки, номер рядка коментаря зсувається разом із його текстом.
- Разом із файлом. Перейменуйте або перемістіть його в DotMD, і коментарі переїдуть разом із ним. Перейменуйте або перемістіть його у Finder чи через
git mv, і вони повернуться, коли ви вперше відкриєте файл на новому місці. - Місяць після зникнення файлу. Коментарі видаленого файлу стираються приблизно через місяць разом з історією його версій.
Запитання про коментарі в DotMD
Чи зберігаються коментарі в .md-файлі?
Ні. Їх зберігає DotMD, тож у файлі немає ні маркерів, ні HTML-коментарів, а інші застосунки бачать його таким, яким він був.
Чи можна коментувати без агента?
Так, як нотатки для себе до чернетки.
Що буде, якщо перейменувати або перемістити файл?
Якщо перейменувати в DotMD, коментарі переїдуть разом із файлом. Якщо перейменувати у Finder чи в git, вони повернуться, коли ви вперше відкриєте файл на новому місці.
Чи потрібен DotMD Pro, щоб коментувати?
Так. Коментарі та рев’ю входять до DotMD Pro: річна підписка з 3 днями безкоштовного пробного періоду або Lifetime. Читати можна безкоштовно.