+と−の壁ではなく。整形されたページ上の変更。

文章では行ごとの差分が読みにくい理由

行ごとの差分は、テキストを1行ずつ比べます。コードでは、1行が意味の単位なので、うまくいきます。文書ではそうなりません。段落はたいてい長い1行なので、1語を変えただけで段落全体が、赤で削除され、緑で追加されたように見えます。段落の折り返しを変えても同じです。結局、変わった1語を探し回ることになります。

表はもっと厄介です。セルが1つ変わると、パイプとダッシュの行が1つ変わったことになります。見たいのは、整形された表と、変わった行のマークです。

DotMDは、読んでいるページ上で違いを示します。見出し、段落、リスト項目、コードブロック、表の行について、追加されたものは緑、削除されたものは赤の取り消し線です。

バージョン履歴を開く

ツールバーの⑂ボタンか⌥⌘Yを押すか、File → Show Version Historyを選びます。ウィンドウはGoogle Docsのような履歴モードに切り替わります。バージョンは右側に日ごとに並び、先頭がCurrent versionです。選んだバージョンはページの代わりに整形して表示され、その前のバージョンからの変更が強調されます。

• Highlight changesは色をオフにして、そのときのバージョンをそのまま見られます。
• Restoreは、選んだバージョンを戻します。現在のテキストは先にバージョンとして保存されるので、復元は取り消せます。
• Done（⌘↩）で、履歴モードを終わります。

バージョンはスナップショットとして保存されます。フォルダを追加したとき、DotMDが起動したとき、AIエージェントやgit、別のエディタなどほかのアプリがファイルを変更したとき、ファイルを開く、離れる、編集を終えるときです。古いものはTime Machineのように間引かれ、1ファイルあたり最大200です。履歴は便利機能で、バックアップではありません。

1つだけ取り消して、残りは残す

バージョンを復元すると、ファイル全体が戻ります。たいていは、もっと小さくしたいものです。新しいテキストは残して、1つの段落だけ戻したい、というように。DotMD Reviewerなら、現在のバージョンで、変わった各ブロックの古いテキストが赤で、新しいテキストの真上に並びます。

1. 取り消すものにマークを付ける

   変更にカーソルを合わせ、赤いテキストの↩ Revertをクリックします。追加されただけの段落には、代わりに✕ Removeが表示されます。ページには、どう見えるようになるかが表示されます。

2. 適用する

   Apply Revertsをクリックします。ファイルには、それらの変更だけが取り消された状態で書き込まれ、残りはそのままです。Cancelはマークを破棄します。直前のテキストはバージョンとして保存されるので、これも取り消せます。

AIエージェントがファイルを編集したあと

前回開いてから別のアプリが変更したファイルには、サイドバーにオレンジの点が付きます。開くと、DotMDはその変更に直接移り、前回見てからのすべてが強調されます。開いているファイルが変わった場合は、バナーに追加・削除された行数が出て、Show Changesで比較が開きます。

エージェントがコメントに対して行った修正をレビューするときは、変更が各コメントの横に表示され、どのコメントにも頼まれていない編集はother changesとして数えられます。エージェントの意外な動きが隠れているのは、そこです。変更のレビューを参照してください。

git diffとDotMD、どちらを使う？

プルリクエストでコードをレビューするなら、gitです。行ごとの差分は、そのためにあります。文書で何が変わったか、つまりスペック、プラン、README、比較表を読むなら、DotMDです。両者は競合しません。DotMDはリポジトリがなくても動き、コミットされなかった変更も捉えます。

Markdownの差分についての質問

その他の質問