Get your Kindle highlights and notes into your ebook library
Connect the Kindle to your Mac with its cable, open “Sync” in Readwyn's sidebar, and review and apply the “Device → Readwyn” direction. It copies the highlights and notes of the books that are both on the Kindle and in your library, and from then on they sit in Readwyn's Notebook, by chapter, each with its page. This needs a Kindle that the Mac mounts as a drive, because Readwyn reads the files on the Kindle and has no other way in. Amazon's help page on USB transfers says the Kindle Scribe and the Kindles released in 2024 need a separate app on a Mac, such as Amazon's own Send to Kindle, to move files over a cable, and that models released earlier than 2024, the Scribe excepted, don't. A Kindle that needs such an app doesn't mount as a drive, so it's out of Readwyn's reach.
Where the highlights come from
A Kindle has no database of highlights. It keeps them in a file beside each book, and Readwyn reads that file: the .mbp file of a Kindle with firmware 1 to 4, or the files in the book's .sdr folder on firmware 5 and later (syncing a Kindle with a Mac lists the models of each). For a MOBI or an AZW3 book these files record the exact position of each highlight, so Readwyn can find the same passage in the EPUB of your library and store its chapter, its page, and the paragraphs around it. A book that Readwyn itself put on the Kindle with “Send to device” lines up exactly, since the MOBI it sends has the same text as the library's EPUB. One case fails. Readwyn can't read the text of a MOBI or AZW3 file with DRM, and on firmware 5 and later the Kindle's file gives only where a highlight is, not its words. On those Kindles, the highlights and notes of a book with DRM don't come in.
Books in Amazon's KFX format are different, because Readwyn can't read a KFX file. For those it falls back on documents/My Clippings.txt, the running list that a Kindle adds every highlight and note to (the Kindle Colorsoft user guide calls it My Clippings). The file gives the text of a highlight but only a Kindle location for its place, so Readwyn searches for the words in your EPUB. That route has a few quirks:
- A highlight you deleted on the Kindle is still in the file, so it comes into the library anyway.
- A Kindle can cut a clipping short. It writes “<You have reached the clipping limit for this item>” where the rest of the text should be, and Readwyn keeps the text before that mark and skips a highlight that has none. Amazon's own export has a limit of this kind: Readwise, a service that imports Kindle highlights, says publishers require Amazon to limit how much highlighted text can be exported from a book.
- A note with no highlight under it is left out, as there's no text to look for.
- A highlight in a PDF has a page but no location, and Readwyn doesn't read it.
Two things hold for every Kindle. Bookmarks aren't read. And a Kindle highlight carries no colour that Readwyn can read, so each new one arrives yellow. Give it another colour in Readwyn and later syncs leave your choice alone.
Reviewing the sync
On the Sync screen, the “Device → Readwyn” card says “Bring progress, highlights and notes from the Kindle into the library.” A Kindle with firmware 5 or later adds My Words to that list. Below the sentence are a count of the changes and a button to review them.
Nothing is copied until you've looked at the list. The review sheet groups the changes by book: a new highlight is a row marked “Add · Highlight” with its text, and one that has a note is “Add · Note”. Untick a row and it stays behind. The button at the foot counts the ticked rows, for example “Apply 7 changes”, and a click on it does the copy. At the top is “Merge highlights, notes and words instead of replacing them”, which is on by default. Leave it on, and the sync deletes no highlight. Turn it off, and the library's highlights of each synced book become exactly the Kindle's, so anything you highlighted in the reader on the Mac in those books would go. The review lists each deletion before you apply the sync.
A book that is on the Kindle but not in your library appears under “Left out” with the reason “Not in this library.” Add it, and the next review has its highlights. For a KFX book that means an EPUB of the same title, since the EPUB is where Readwyn looks for the words. A book that you copied to the Kindle without Readwyn is paired with the library book of the same title.
Highlights and notes travel one way only. Under “Not available on this Kindle”, the Sync screen lists “Highlights and notes to the device” with the reason: no public description tells how to write a highlight into a Kindle's files, and on firmware 1 to 4 a wrong record can cost the Kindle its own notes. So a note you add or edit on the Mac doesn't reach the Kindle. The Kindle still has its own version, and each later “Device → Readwyn” review lists the difference: “Update · Note” if the Kindle has another note for that highlight, “Delete · Note” if it has none. The merge option doesn't cover these rows. Untick the row, if it's ticked, to keep the text you wrote on the Mac. The first sync you apply does write one small file to the Kindle, .readwyn/device-id, a random ID by which Readwyn knows the device next time.
In the Notebook

“Notebook” in the sidebar lists every book with highlights, and a click on one shows its highlights in reading order under their chapter titles. The page at the right is the printed page if the book has a page list, and an estimate such as “~p. 196” if it doesn't. A clipping whose words aren't in your EPUB, from another edition for instance, has no page and no context. It goes to the end of the list under “Not found in this copy”. All your highlights in one notebook goes through the rest of the screen.
A Markdown file for Obsidian or Notion
Above a book's highlights, “Export” offers “Markdown…” and “Plain text…”. Either opens the macOS save panel in Documents with a name filled in, such as “Middlemarch - Highlights.md”. For the book in the picture, the Markdown file begins:
# Middlemarch
George Eliot
## Prelude
> Here and there is born a Saint Theresa, foundress of nothing, whose loving heart-beats and sobs after an unattained goodness tremble off and are dispersed among hindrances, instead of centring in some long-recognizable deed.
>
> — p. 3
The whole book in one sentence.
## Book I · Chapter I
> Miss Brooke had that kind of beauty which seems to be thrown into relief by poor dress.
>
> — p. 7
The title is a first-level heading with the authors under it, each chapter is a second-level heading, each highlight is a block quote that ends with its page, and a note is an ordinary paragraph below its quote.
Obsidian needs no import step. Its help says it keeps notes as Markdown-formatted plain text files in a vault, that a vault is a folder on your disk, and that it refreshes the vault by itself when something changes there from outside. Choose a folder inside your vault in the save panel, and the book's highlights turn up as a note. Notion takes the same file through an import: its help page gives the path as Settings, then Import, then “Text & Markdown”, where you upload the .md file.
The export covers one book at a time, and the file holds what the library had when you saved it. After a later sync brings in more highlights, export the book again.
For a Kindle that doesn't mount on a Mac, where your Kindle highlights are gives the routes that Amazon offers instead.