Skip to content
| Marketplace
Sign in
Visual Studio Code>Visualization>Document ReviewNew to Visual Studio Code? Get it now.
Document Review

Document Review

PumasAI

| (0) | Free
View PDF, Word and HTML reports in VS Code, and comment on them for a colleague or an AI agent to act on.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

Document Review

Open HTML, PDF and Word reports in VS Code, and comment on them as you read. The comments go into a JSON file next to the report, for a colleague or an AI agent to work through.

A study report open as a PDF, with a reviewer's comment open on a highlighted sentence, and the Document Outline listing the comments under the report's sections

Supported files

These open in the preview when you open them in VS Code:

Format Extensions
HTML .html, .htm
PDF .pdf
Word .docx

To open an HTML file as text, click Open Source in the editor's title bar, or turn off Open By Default in the settings. To open a file in the app your computer uses for it, such as Word for a .docx, choose Open in Default App from the editor's ... menu.

Reading a report

The toolbar above the pages shows the page you are on. Type a page number into its box and press Enter to go there. At the right, the magnifiers zoom out and in, and a click on the zoom between them returns to 100%. Fit width and Fit page fit the pages to the editor, and keep them fitted as you resize it. A PDF opens fitted to the editor's width, and a Word document at 100%.

The Document Outline in the Explorer lists the report's headings. Click one to go to its section. As you scroll, the outline highlights the section you are reading.

The preview shows each new version of the file in place, as when you render a Quarto report again, and keeps your page and zoom. A tab you switch away from opens where you left it, even after you restart VS Code.

Finding text

Cmd+F (Ctrl+F on Windows and Linux) opens the find bar. It highlights every match and counts them, and Enter and Shift+Enter step through them. Match Case and Match Whole Word sit in the box, as in VS Code's own find. A search of a PDF covers every page, not only the ones you have scrolled to.

A Word report with "AUC" found five times, the first match highlighted in the methods, and the outline open on the sections

Shortcut Action
Cmd+F / Ctrl+F Find in the report
Cmd+= / Ctrl+= Zoom in
Cmd+- / Ctrl+- Zoom out
Cmd+0 / Ctrl+0 Zoom to 100%
Cmd or Ctrl with the scroll wheel, or pinch Zoom in or out
Cmd+Alt+M / Ctrl+Alt+M Comment on the selected text, or on the whole report

Dark themes

In a dark theme, the half-filled circle at the right of the toolbar turns white pages dark, in every PDF and Word preview at once. Colours keep their hue, so a blue line in a plot stays blue. A Word document's images keep their own colours, while a PDF's images change with the page.

The concentration-time figure of a PDF report shown with dark pages, its coloured lines still telling the doses apart

Commenting on a report

Comments let you review a report where you read it, without marking up the report itself. The comment buttons sit in the editor's title bar, for every format:

  • Select some text and click Comment beside it, or press Cmd+Alt+M.
  • Point at a figure or table in an HTML or Word report and click Comment on figure or Comment on table.
  • In a PDF, click Comment on an Area in the title bar, then drag a box over the page, such as around a plot. Click Stop Commenting on an Area or press Escape to stop.
  • With nothing selected, Add Comment in the title bar, or Cmd+Alt+M, comments on the whole report.

Commented text is highlighted. Click it to read the comment. From there you can edit it, resolve it or delete it.

An HTML report with a comment open on its concentration-time figure, which is outlined in blue

The Document Outline lists the comments under the sections they are in, with the comments on the whole report first. A comment moves to Not found at the end when the report no longer holds its text, usually because the author rewrote it. The outline's badge counts the open comments. Each row has buttons to resolve or delete its comment, and the buttons above the outline add a comment, delete the resolved ones, and open the comments as a list.

The list of comments

The comments live in a file beside the report: report.pdf.review.json beside report.pdf. The report itself never changes. Open that file to see the comments as a list, grouped by section, with a filter for open or resolved comments and a box to search them. Click a comment to open the report beside the list, with the comment shown.

The list of comments on a report, grouped by section, with one resolved comment showing the author's reply

Handing the comments to an author or an AI agent

The review file is plain JSON, made for whoever changes the report's source, such as a Quarto, R Markdown or Typst file. Point your colleague or your AI agent at it and ask them to work through the open comments. Each comment says what it is about and where, so they can find the place in the source without you pointing to it. For each comment they address, they set its status to resolved and write what they changed in its reply. The preview shows the replies as soon as they save the file.

{
  "version": 1,
  "document": "report.pdf",
  "comments": [
    {
      "id": "c-1b7e3c20",
      "created": "2026-11-18T09:30:00.000Z",
      "body": "Give the slope and its 90% CI here, so the summary stands on its own.",
      "quote": { "exact": "Exposure rose in proportion to dose from 50 to 200 mg", "prefix": "about 2 hours after dosing. ", "suffix": ". The terminal half-life was" },
      "position": { "page": 1, "start": 1132, "end": 1186 },
      "section": ["Summary"],
      "status": "open"
    }
  ]
}
Field Meaning
id The comment's identity. Keep it when you change the comment.
created When the reviewer wrote it.
body The comment.
quote The text the comment is on, with up to 32 characters either side, in the form of the W3C Web Annotation TextQuoteSelector. Ligatures are split, quotes are straight, spaces are single, and a word broken across a line is joined, so the text reads as the source does. On a figure, it is the figure's caption, or the text inside the box.
position Where the quote sat in the report's text, and on which page of a PDF. It tells repeats of the same words apart. On a figure or an area, it marks where the figure sits in the text, so the comment lists in reading order.
region A figure or table, as { "element": "image" \| "table", "index": n } in an HTML or Word report, or a box on a PDF's page, as { "page", "x", "y", "width", "height" } in fractions of the page.
section The headings above the comment.
source The line of the source the text came from, when the HTML carries it, as Pandoc's data-pos. Quarto writes it with from: commonmark_x+sourcepos.
status open or resolved.
reply The answer to the comment, which the reviewer sees beside it.

A comment with no quote and no region is about the whole report. Fields you add are kept, so an agent can record its own notes.

HTML reports

An HTML report shows as in a browser, with the images, styles and scripts beside it, so a Quarto or R Markdown report with interactive tables and plots works as it does in a browser. Its scripts run only once you trust the workspace. A link to another file beside it, such as the PDF of the same report, opens that file in VS Code.

An HTML report fills the whole preview, with no toolbar above it. Its zoom buttons sit in the editor's title bar instead, beside the comment button and Open Source.

Open Preview to the Side shows the preview beside the HTML source, and the preview follows your edits as you type, before you save.

Settings

Search for "Document Review" in VS Code's settings.

  • HTML: Open By Default opens HTML files in the preview. Turn it off to open them as text.
  • Invert Page Colors turns white pages dark in a dark theme, as the toolbar's button does.

Your documents

Document Review never changes your documents. Comments go in their own file beside the report. The extension itself never connects to the internet. An HTML report may load images, fonts or scripts from the web, as it would in a browser.

Remote windows and large files

A report opens quickly however large it is, and in a remote window, such as SSH, WSL or a dev container, VS Code moves only what you read:

  • A PDF loads only the pages you look at. A 150 MB report of 600 pages shows its first page after about 4 MB.
  • A search of a PDF reads the text where the file lives and moves only the text, not the pages' images.
  • A Word document arrives without its large images, and each image loads as you scroll near it.
  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft