Не стена из + и −.Изменения на отрисованной странице.

Почему построчный diff плохо читается для прозы

Построчный diff сравнивает текст строка за строкой. В коде это работает, потому что строка — единица смысла. В документе нет: абзац часто идёт одной длинной строкой, поэтому из-за одного слова весь абзац показывается удалённым красным и добавленным зелёным. То же происходит при переносе абзаца иначе. В итоге вы ищете то единственное слово, которое изменилось.

С таблицей ещё хуже. Изменённая ячейка — это изменённая строка из вертикальных черт и дефисов. А хочется видеть отрисованную таблицу с отмеченной изменённой строкой.

DotMD показывает разницу на странице, которую вы читаете: заголовки, абзацы, пункты списков, блоки кода и строки таблиц, добавленные зелёным, удалённые красным и зачёркнутые.

Откройте историю версий

Нажмите кнопку ⑂ на панели инструментов, ⌥⌘Y или выберите File → Show Version History. Окно переключается в режим истории, как в Google Docs. Версии перечислены по дням справа, сверху Current version. Выбранная версия показана отрисованной вместо страницы, с выделенными изменениями относительно предыдущей.

• Highlight changes выключает цвета, чтобы увидеть версию как она была.
• Restore возвращает выбранную версию. Текущий текст предварительно сохраняется как версия, так что восстановление можно отменить.
• Done (⌘↩) выходит из режима истории.

Версии сохраняются как снимки: когда вы добавляете папку, когда запускается DotMD, когда другое приложение, например ИИ-агент, git или другой редактор, меняет файл, и когда вы открываете файл, уходите из него или заканчиваете правку. Старые прореживаются, как в Time Machine, не более 200 на файл. История — это удобство, а не резервная копия.

Откатите одну правку, остальное оставьте

Восстановление версии возвращает весь файл. Часто нужно меньше: оставить новый текст, кроме одного абзаца. С DotMD Reviewer в текущей версии каждый изменённый блок показан как старый текст красным прямо над новым текстом зелёным.

1. Отметьте, что откатить

   Наведите на правку и нажмите ↩ Revert на её красном тексте. У абзаца, который был только добавлен, вместо этого ✕ Remove. Страница показывает, как всё будет выглядеть.

2. Примените

   Нажмите Apply Reverts. Файл записывается с откатом только этих правок, остальное остаётся. Cancel снимает пометки. Прежний текст сохраняется как версия, так что и это можно отменить.

После правки файла ИИ-агентом

Файлы, которые другое приложение изменило с момента вашего последнего открытия, получают в боковой панели оранжевую точку. Откройте такой файл, и DotMD сразу перейдёт к его изменениям, выделив всё с вашего последнего просмотра. Если открытый файл меняется, баннер сообщает, сколько строк добавлено и удалено, а Show Changes открывает сравнение.

Когда вы проверяете исправления агента по вашим комментариям, изменения показаны рядом с каждым комментарием, а правки, о которых не просил ни один комментарий, считаются как other changes. Именно там прячутся сюрпризы агента. См. Проверка правок.

Git diff или DotMD?

Git используйте для ревью кода в pull request: для этого и нужен построчный diff. DotMD используйте, чтобы прочесть, что изменилось в документе: в спецификации, плане, README, сравнительной таблице. Они не конкурируют. DotMD не нужен репозиторий, и он ловит также изменения, которые так и не были закоммичены.

Вопросы о diff Markdown

Другие вопросы