Compare Markdown online

Two versions of a short guide with new headings, reworded bullet points and a different list style. Paste your own README or docs. Tips for Markdown

Original
0 lines
Drop to load into original
Changed
0 lines
Drop to load into changed
−0+0
Original
Changed

About this Markdown comparison

READMEs, docs, changelogs and notes are mostly Markdown. When several people edit the same document, a Markdown diff shows which headings, paragraphs and list items changed, and marks the reworded phrases inside them.

The comparison is on the Markdown source, so changes in syntax, such as switching list markers, are visible too.

What changed in this sample

  • The title and two section headings were renamed: “Guide” to “Overview”, “Features” to “Benefits”, “Usage” to “Examples”.
  • The introduction paragraph was rewritten.
  • All three bullet points under the features heading were reworded.
  • The example list switched from - to * markers and from numbers to letters.

Tips for comparing Markdown

Long paragraphs
Markdown paragraphs are often one long line. Keep Wrap lines on so the whole paragraph is visible with the changed words marked.
Reflowed text
If one version was re-wrapped at 80 characters, the lines will not match. Join the lines of both versions the same way before comparing.
Changelogs
Compare two releases of a CHANGELOG.md; Fold unchanged leaves just the new entries.
Share for review
Create a share link so a co-author can see exactly what you changed.

How to compare Markdown online

  1. Paste the older version into Original and the newer one into Changed, or open a file on each side.
  2. Check that the syntax menu says Markdown, then pick split or unified view.
  3. Step through the changes with the arrows or Alt ↓, and use Settings for options such as ignoring blank lines.
  4. Save the comparison in your browser, share a link, or download it as a .diff, HTML or PDF.

Markdown comparison: questions

Does it compare the rendered Markdown?

No, it compares the Markdown source. That way changes in formatting syntax are visible as well as changes in wording.

Can I compare a README from two branches?

Yes. Copy the raw README from each branch on GitHub or GitLab and paste them into the panes.

Are tables and code blocks supported?

Yes. They are compared line by line like the rest of the document.