Não um muro de + e −.As alterações, na página formatada.

Porque é que um diff por linhas é difícil de ler em prosa

Um diff por linhas compara o texto linha a linha. No código funciona, porque uma linha é uma unidade de sentido. Num documento não: um parágrafo é muitas vezes uma só linha longa, por isso mudar uma única palavra faz o parágrafo inteiro aparecer removido a vermelho e adicionado a verde. Reformatar a quebra de um parágrafo faz o mesmo. Acaba a procurar a palavra que mudou.

Uma tabela é pior. Uma célula alterada é uma linha de barras verticais e hífenes alterada. O que quer é a tabela formatada com a linha alterada assinalada.

O DotMD mostra a diferença na página que está a ler: títulos, parágrafos, itens de lista, blocos de código e linhas de tabela, os adicionados a verde, os removidos a vermelho, riscados.

Abra o histórico de versões

Prima o botão ⑂ na barra de ferramentas, ⌥⌘Y, ou escolha File → Show Version History. A janela passa ao modo de histórico, como no Google Docs. As versões estão listadas por dia à direita, com Current version no topo. A versão selecionada aparece formatada no lugar da página, com o que mudou desde a versão anterior realçado.

• Highlight changes desativa as cores, para ver a versão como estava.
• Restore repõe a versão selecionada. O texto atual é primeiro guardado como versão, por isso um restauro pode ser anulado.
• Done (⌘↩) sai do modo de histórico.

As versões são guardadas como instantâneos: quando adiciona uma pasta, quando o DotMD arranca, sempre que outra app, como um agente de IA, o git ou outro editor, altera o ficheiro, e quando o abre, o deixa ou termina de o editar. As mais antigas são reduzidas como no Time Machine, com no máximo 200 por ficheiro. O histórico é uma comodidade, não uma cópia de segurança.

Anule uma alteração, mantenha o resto

Restaurar uma versão repõe o ficheiro inteiro. Muitas vezes quer menos: manter o texto novo exceto um parágrafo. Com o DotMD Reviewer, na versão atual cada bloco alterado é mostrado com o texto antigo a vermelho mesmo por cima do novo a verde.

1. Marque o que anular

   Passe o rato por cima de uma alteração e clique em ↩ Revert no seu texto vermelho. Um parágrafo que apenas foi adicionado tem ✕ Remove. A página mostra como vai ficar.

2. Aplique

   Clique em Apply Reverts. O ficheiro é escrito apenas com essas alterações anuladas, e o resto fica. Cancel descarta as marcas. O texto anterior é guardado como versão, por isso até isto se pode anular.

Depois de um agente de IA editar o ficheiro

Os ficheiros que outra app alterou desde a última vez que os abriu têm um ponto laranja na barra lateral. Abra um e o DotMD vai direto às suas alterações, com tudo o que aconteceu desde a última vez realçado. Se o ficheiro aberto mudar, um aviso diz quantas linhas foram adicionadas e removidas, e Show Changes abre a comparação.

Quando revê as correções de um agente aos seus comentários, as alterações são mostradas junto a cada comentário, e as edições que nenhum comentário pediu são contadas como other changes. É aí que se escondem as surpresas de um agente. Veja Rever alterações.

Git diff ou DotMD?

Use o git para rever código num pull request: é para isso que serve um diff por linhas. Use o DotMD para ler o que mudou num documento: uma spec, um plano, um README, uma tabela comparativa. Não competem. O DotMD não precisa de um repositório e também apanha as alterações que nunca foram submetidas.

Perguntas sobre diffs de Markdown

Mais perguntas