How to export Kobo highlights on a Mac
Readwyn exports highlights from its Notebook, so they have to come off the Kobo first. A Device → Readwyn sync copies them into your library. Then you pick the book in the Notebook and click “Export”, which saves its highlights and notes as a Markdown or plain-text file with chapter titles and a page for each highlight.
Getting the highlights off the Kobo
With the Kobo plugged in, open “Sync” in the sidebar and click the review button on the “Device → Readwyn” card. The review sheet lists each new highlight with its text, grouped by book, and you can untick any you don’t want before you apply them.
A Kobo book that isn’t in your library is skipped, and so are dog-ears and stylus drawings. Highlights travel the other way too: highlight a book on the Mac and the next Readwyn → Device puts those highlights on the Kobo, as long as the book is there.
On the way in, Readwyn also looks for each highlight in your copy of the book and saves its page, so the export keeps its page numbers after the Kobo is unplugged.
The Notebook
“Notebook” in the sidebar collects the highlights of your whole library. On the left is every book you’ve highlighted, with counts such as “14 highlights · 3 notes”. Click one and its highlights appear on the right in reading order, under their chapter titles, each with a coloured dot and a page number.
Chips above the list filter it by highlight colour, and “Search highlights and notes” looks through every highlight and note in the library.
Export
Above the book’s highlights are three buttons: “Copy all”, “Export”, and “Open book”. “Export” offers “Markdown…” and “Plain text…”. Either one opens the save panel in Documents with a name already filled in, such as “Middlemarch - Highlights.md”. The file contains the book’s title and authors, each chapter title, and every highlight with its page and its note.
Which page you get depends on the book. If it has a page list, it’s the printed page. If not, Readwyn estimates the page from the book’s page count, and a book without a page count gets a percentage instead.
The Markdown file suits a notes app that works on plain files. Obsidian’s help says it keeps notes as Markdown-formatted plain text files in a vault, which is a folder on your disk. Choose a folder inside your vault in the save panel, and the book’s highlights turn up there as a note. The post on Kindle highlights shows how such a file begins, and how Notion imports one.
If you only want the text somewhere else, “Copy all” puts every annotation of the book on the clipboard. Hover over a single highlight and “Copy” takes just that one, page included, or you can select part of a highlight and copy it. The Highlights tab on the book screen has “Copy all” too, next to “Open in Notebook”.
Highlights from another edition
Sometimes a highlight was made in a different edition from the one in your library. If Readwyn can’t find its place, page, or context in your copy, it goes to the end of the list under “Not found in this copy”, with a count and the name of the device it came from. It isn’t thrown away.