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
- Paste the older version into Original and the newer one into Changed, or open a file on each side.
- Check that the syntax menu says Markdown, then pick split or unified view.
- Step through the changes with the arrows or Alt ↓, and use Settings for options such as ignoring blank lines.
- 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.