In the Library, open More (⋮) and choose Import from Other Apps… An empty Library shows the same option. Choose one or more files. Highlight reads supported CSV, Markdown, and JSON exports.

Preview what Highlight will add and what it will skip, with reasons for skipped highlights. It skips highlights already in your Library with the same page and text, and keeps only one copy of repeats within a file. You won’t get duplicates if you choose the same file again.

Each import brings in up to 2,000 new highlights across all the files you choose. If there are more, the preview says so. Import the same files again to bring in the rest, and repeat if needed. Highlight reads the files on your device. Nothing is uploaded. Imported highlights follow your iCloud Sync setting like the rest of your Library.

Readwise

Readwise’s Markdown export is the one to use. Its CSV export doesn’t include a page link for each highlight, so Highlight can’t import from it.

  1. Open Readwise’s export page (in Readwise, Export Highlights).
  2. Choose Markdown at the bottom of the page. Leave Use Custom Formatting off, because the default format includes each article’s link.
  3. Choose Export, then Download Highlights, and unzip the file it downloads.
  4. In et al., choose Import from Other Apps… and select the unzipped .md file (or files).

Readwise’s Markdown export doesn’t include dates, so these highlights appear under Date unavailable. Book highlights don’t have a page link, so Highlight skips them. Highlights from web articles come through.

Hypothesis

Hypothesis exports as JSON with the context around each highlight, so imported highlights come back on the page the way highlights made in et al. do.

  1. Open the Hypothesis sidebar on a page you’ve annotated.
  2. Open the Share panel, then the Export tab.
  3. Choose JSON, then Export.
  4. In et al., choose Import from Other Apps… and select the exported .json file.

Highlight skips replies to other annotations and page notes with no highlighted text.

Obsidian and other Markdown

Highlight reads a Markdown file where each highlight has a page link and the highlighted text. The link can be in frontmatter (source:, url:, or link:) or in a line like Source: [url](url). Highlights can be written as > blockquotes or ==marked== text.

et al.’s own Markdown export uses this format. You can export a file and import it back into the same Library or another one.

Take your highlights to Zotero

et al. Pro can send a citation with your highlights and notes to Zotero. In the Citations panel, choose RIS as the format. On the source card, turn on Highlights and Notes. Each highlight, with its note, becomes one note in the RIS file, and Zotero adds it as a child note under the reference.

With Highlights and Notes off, the RIS file contains only the reference. BibTeX and CSL-JSON downloads contain only the reference either way. The RIS file also includes the website title, so Zotero fills in Website Title on import.

  1. Open Citations for a source in your Library.
  2. Choose RIS as the format.
  3. Turn on Highlights and Notes on the source card.
  4. Choose Download.
  5. In Zotero, choose File, then Import, and pick the .ris file.

Other apps

Coming from another app? If it exports a CSV with a column for the highlighted text and a column for the page link, Highlight can read it. Highlight looks for a set of common header names:

  • Highlighted text: A column named highlight, quote, text, or annotation.
  • Page link: A column named url, link, source url, or page url.
  • Title: A column named title.
  • Note: A column named note or comment.
  • Tags: A column named tags.
  • Color: A column named color.
  • Date: A column named date or created.

The preview shows exactly what Highlight will add before anything changes. You can check the preview before you import.

What gets imported

  • Highlights and notes: The highlighted text, and any note that came with it.
  • Tags and colors: Tags carry over. In a CSV, separate several tags in one cell with commas. A recognized color name carries over. Anything else comes in as yellow.
  • Dates, when they’re unambiguous: Otherwise the highlight appears under Date unavailable.
  • A source to cite: Highlight starts with the page’s URL and title. Open the page once and Highlight fills in the details it can find.

Imported highlights are ready to search, organize, and cite in your Library right away. On the original page, they show up again the next time you open it, once et al. finds the passage.

Bring your highlights with you

Download Highlight for Mac, iPhone, and iPad.