Skip to content

PDF annotations, written into the source

Highlights and comments from a PDF go into the Markdown source in place, with author and date.PDF highlights and comments in Markdown source.

PDF annotations, written into the source

Highlights and comments in a PDF usually stay inside the reader. The source view writes them into Markdown in place, with author and date, ready to organize, search and hand to other tools.

When it helps

Review comments and your own notes live on the PDF, and a different reader shows only some of them. Turning them into a revision list means copying each one by hand, with nothing to tie it back to its place in the text.

  • A PDF already full of highlights and comments
  • Comments you want to turn into a revision list
  • Annotations to hand to another tool along with the text
In this guide
  1. An annotated PDF in the source
  2. Author and date in footnotes
  3. Highlights and comments from a selection

An annotated PDF in the source

Open a PDF that carries highlights and comments. The page shows the highlights and the comment marks. Switch to the source view and turn on Annotations. Highlighted text is written as {==text==} with a footnote number, in the same place as the highlight in the reading view.

The annotated PDF on the left and its Markdown source on the right, in step
The annotated PDF on the left and its Markdown source on the right, in step

Author and date in footnotes

Each footnote records the annotator, type, date and comment, so review notes and discussion stay with the source.

Two footnotes in the source, each with its author, type, date and comment
Two footnotes in the source, each with its author, type, date and comment

Highlights and comments from a selection

Select a sentence in the reading view. The selection bar offers highlight colors, comment, copy and add to notes.

The selection bar over a sentence selected in the reading view
The selection bar over a sentence selected in the reading view

What you get

Highlights and comments become searchable, portable text alongside the body, with the commenter and the time kept.

Features in this post

PDF annotationHighlights and notes stay anchored to textSource viewMarkdown source beside the reading view

For macOS and Windows

Figurable Office makes document processing, typesetting and translation easy for researchers.Easy document processing, typesetting and translation for researchers.