Markdown PR — Markdown PR Comments for GitHub

Comment, reply, resolve, and collapse sections directly in GitHub PR rich-diff (rendered markdown) view.

🆕 What's new in recent releases v1.5.1 (2026-06-16) • Fixed: comments on Markdown files with YAML frontmatter (the `---` ... `---` block at the top of design docs and dev plans) now anchor to their real source lines instead of landing at the bottom of the file. • New: hover any row in the metadata block at the top of a file and click `+` to comment on `area:`, `status:`, `related:`, etc. v1.5.0 (2026-06-12) • New "Changes" tab in the sidebar — jump between added / removed / modified blocks without re-reading the kept prose. Step with `[` / `]`, or press `1` / `2` / `3` to switch sidebar tabs. • Renamed to "Markdown PR — Markdown PR Comments for GitHub" so narrow contexts like the browser toolbar tooltip and store carousel cards show a short prefix that fits. v1.4.0 (2026-06-05) • Editing your own comment is now one click — a direct `Edit` link sits in the comment header next to `GitHub ↗`. 📌 Just installed? Hard-refresh (Ctrl+Shift+R / Cmd+Shift+R) any GitHub PR tab that was already open when you clicked Get — the extension only activates on tabs loaded AFTER install. New tabs work automatically. — GitHub's "Files changed" rich-diff renders Markdown beautifully — design docs, dev plans, READMEs — but provides no way to click on a paragraph and leave a review comment. You have to flip back to source-diff mode to comment, then back again to see how it renders. This extension closes that gap. What it does: • Hover any paragraph, heading, list item, table row, or code block in rich-diff and a blue "+" appears. Click it, type a comment, click Comment. The comment posts as a real PR review comment on the correct source line. • Drag the "+" from one block to another to leave a multi-line range comment. • Existing review threads render inline as "N comments" badges, anchored to the rendered block they belong to. Expand a thread to read, reply, resolve, or unresolve — all without leaving rich-diff. • Comment box matches GitHub's UI: Markdown toolbar, Write / Preview tabs, @mention autocomplete, Cmd/Ctrl+Enter to submit. • Threads sidebar — a draggable, resizable panel lists every review thread on the page, with prev / next navigation, an "unresolved only" filter, and j / k / h / l keyboard shortcuts. Press `t` to toggle the sidebar, `Shift+T` to reset its position. • Changes tab — a list of every changed block in document order with an added / removed / mixed glyph and a snippet, so you can scan the edits without reading the kept prose. Step through with `[` / `]` or use the header `◀ N/M ▶` counter. Press `1` / `2` / `3` to switch sidebar tabs from the keyboard. • "Render all Markdown files as rich-diff" in one click — a book icon in the sidebar header opens every .md file in the PR as rich-diff at once, so all comments on Markdown files load without you having to toggle each file by hand. • Outline tab — a heading tree of every modified Markdown file with a comment-count pill per section; click to jump, fold individual sections or bulk-fold by level (Fold H1 / H2 / H3 / Expand all). • Heading anchor links (Table of Contents) work in rich-diff — clicking `[Section](#section)` scrolls to the heading. • Avatars and GitHub-native role badges (Author, Owner, Member, Contributor, First-time contributor, …) on every comment. • Collapse sections by heading to focus on what's left to review. No Personal Access Token required — uses your existing GitHub session cookies. Works on public and private repos. No third-party servers, no telemetry, no analytics. Best for PRs that include Markdown content — design docs, dev plans, READMEs, and ADRs. The extension activates wherever GitHub's rich-diff view is available; on source-only files (.js, .py, etc.) GitHub's normal source-diff continues to work as it always has. Open source on GitHub: https://github.com/chienyuanchang/rich-diff-comments — source, issue tracker, and roadmap. — This is an independent, third-party browser extension. It is not affiliated with, endorsed by, sponsored by, or otherwise connected to GitHub, Inc. "GitHub" is a registered trademark of GitHub, Inc., and is used here only to identify the service this extension works with.