Preview Rendered Markdown Diffs in the Dashboard
Suggestion diffs in the Promptless dashboard now include a rendered preview. Click “Preview Markdown” on any .md, .mdx, or .markdown file to see changes as formatted output, with GitHub-style green highlighting for additions and red for removals.
The problem
Section titled “The problem”Reviewing documentation suggestions in a raw diff works for code but is awkward for prose. A diff that changes three sentences shows as six lines of marked-up text. You can tell what was added and removed, but you can’t tell how the paragraph actually reads, whether a table is still properly formatted, or whether a sentence flows correctly after the change.
For MDX files, it was worse. JSX attributes and component tags read as noise in raw diff view. A change to a short prose paragraph could appear as a dense block of angle brackets and props, with the actual prose change buried inside. Reviewers either mentally parsed the noise or skipped the preview and went straight to merging.
What changed
Section titled “What changed”A “Preview Markdown” button now appears on file cards for .md, .mdx, and .markdown files in the suggestion review view. Click it to open a modal showing the rendered before and after, with added content highlighted in green and removed content in red.
The preview renders Markdown formatting, tables, code blocks, and inline HTML. MDX components are rendered as static HTML, so they won’t execute client-side logic, but the surrounding prose, headings, and formatting render correctly. The visual result is close to what the content looks like once published.
Who benefits most
Section titled “Who benefits most”Anyone reviewing documentation suggestions. The raw diff view is still available. The preview is an option for changes where reading the formatted output matters more than seeing the exact diff markers.
Teams with heavy MDX usage will notice it most. Component-heavy files have a high noise-to-signal ratio in raw diff view. The rendered preview cuts that noise.
Non-technical reviewers who can read finished docs but find diff syntax unfamiliar will find it easier to give feedback on the actual content instead of trying to mentally render the diff.
How to use it
Section titled “How to use it”No configuration needed. Open any suggestion in the Review tab and look for “Preview Markdown” on file cards for .md, .mdx, or .markdown files. The button doesn’t appear for other file types.
The preview modal is read-only. To make changes, close the modal and edit in the diff view or via your normal PR workflow.