DotMD
Komentujte Markdownpřímo u pasáže.
Napište poznámku k větě, odstavci nebo řádku tabulky ve vykresleném souboru .md. Nejde o skrývání textu pomocí <!-- -->: komentář zůstává u své pasáže a váš Markdown zůstává čistý.
macOS 14 nebo novější. Čtení je zdarma, DotMD Pro má 3denní zkušební období zdarma.
Rychlá odpověď
Označte text na vykreslené stránce nebo v editoru a stiskněte ⌥⌘M. Pasáž se zvýrazní žlutě a komentář zůstane svázaný se svými řádky. Komentáře uchovává DotMD, ne soubor, takže váš Markdown zůstává čistý. Pošlete je agentovi, nebo je nechte jako poznámky pro sebe.
Jak okomentovat soubor Markdown
Komentář je poznámka k pasáži: větě, odstavci, řádku tabulky nebo položce seznamu. Od něj se odvíjí každá revize a funguje i bez agenta.
-
Označte pasáž
Označte text na vykreslené stránce, nebo v editoru, pokud upravujete.
-
Začněte komentář
Klikněte na Comment vedle výběru, stiskněte ⌥⌘M, nebo zvolte Edit → Add Comment….
-
Napište, co se má změnit
Napište poznámku a stiskněte ⌘↩. Pasáž se na stránce zbarví žlutě. Komentářů můžete nechat, kolik chcete, než je někomu předáte.
Panel Review: Open, In Review, Resolved
Tlačítko Review na panelu nástrojů otevře vpravo panel, kde je každý komentář k souboru jako karta. Karta ukazuje, kdo komentář napsal, kdy, na kterém řádku leží a ke které pasáži patří. Po kliknutí na kartu se stránka posune k pasáži.
| Sekce | Co v ní je |
|---|---|
| Open | Komentáře, kterými se zatím nikdo nezabýval |
| In Review | Komentáře, které agent označil za opravené a čekají, až je přijmete nebo znovu otevřete |
| Resolved | Hotovo: přijaté nebo vyřešené vámi |
Najeďte na kartu a objeví se její tlačítka: Expand, Edit, Resolve, Accept, Reopen a Delete. Komentář, který nevyžaduje změnu, vyřešte sami.
Pište komentáře, podle kterých agent může jednat
Napište komentář tak, jako byste zadávali práci kolegovi: co je špatně a co chcete místo toho. Přesná poznámka vede k přesné opravě.
„Příliš vágní: uveďte tři metriky a jejich prahové hodnoty.“
To funguje lépe než „oprav to“. Až budete připraveni, panel Review nabízí dva způsoby, jak komentáře předat. Pokud vám agent poslal soubor a čeká, klikněte na Send. Jinak zkopírujte hotový prompt tlačítkem Copy a vložte ho agentovi. Další průvodce ukazuje, jak zkontrolovat, co udělal.
Komentáře od agentů
Komentáře jdou oběma směry. Požádejte agenta, aby soubor v DotMD zrevidoval, a on nechá poznámky u řádků, kterých se týkají, místo odpovědi v chatu. Objeví se ve stejném panelu v sekci Open se jménem agenta a jeho vlastní barevnou tečkou, takže Claude Code od Codexu poznáte na první pohled. Můžete je upravit, smazat nebo vyřešit, než je uvidí autor. Jeden agent kontroluje druhého ukazuje celý postup.
Kde se komentáře uchovávají
- V DotMD, ne v souboru. V Markdownu nejsou žádné značky ani HTML komentáře a ostatní aplikace vidí soubor tak, jak byl.
- U své pasáže. Když se nad komentářem přidají řádky, číslo řádku komentáře se posune spolu s textem.
- Se souborem. Přejmenujete-li soubor nebo ho přesunete v DotMD, komentáře se přesunou s ním. Přejmenujete-li ho nebo přesunete ve Finderu či pomocí
git mv, vrátí se při prvním otevření souboru na novém místě. - Měsíc po zmizení souboru. Komentáře smazaného souboru se odstraní zhruba po měsíci, spolu s jeho historií verzí.
Otázky ke komentářům v DotMD
Ukládají se komentáře do souboru .md?
Ne. Uchovává je DotMD, takže soubor neobsahuje žádné značky ani HTML komentáře a ostatní aplikace ho vidí tak, jak byl.
Mohu komentovat bez agenta?
Ano, jako poznámky pro sebe k rozpracovanému textu.
Co se stane, když soubor přejmenuji nebo přesunu?
Při přejmenování v DotMD se komentáře přesunou s ním. Při přejmenování ve Finderu nebo v gitu se vrátí při prvním otevření souboru na novém místě.
Potřebuji k psaní komentářů DotMD Pro?
Ano. Komentáře a revize jsou součástí DotMD Pro: roční předplatné s 3denní zkušební dobou zdarma, nebo Lifetime. Čtení je zdarma.