MobileRead Forums - View Single Post - Libra Colour Kobo Annotations Exporter - Export Your Highlights & Notes to Markdown

apheleia · 06-09-2025, 03:56 PM

Hey everyone! 👋

I've been frustrated with the lack of good options for exporting Kobo annotations in my obsidian, so I created a Python script that automatically extracts all your highlights and notes from your Kobo eReader and exports them to a basic formatted Markdown files - one file per book.

✨ What it does:
Automatically detects your Kobo database (works on macOS but not tested on Linux and Windows)
Extracts all highlights and annotations from your library
Exports each book's annotations to a separate Markdown file
Preserves chapter/location information
Creates automatic backups of existing files
Shows detailed statistics about your reading habits

🔧 Features:
Zero configuration needed - just plug in your Kobo and run
Handles file naming conflicts intelligently
Debug mode for troubleshooting
Verbose output option for detailed info
Clean, readable Markdown output format

📝 Sample Output:

Code:

# Annotations - Book Title

*Exported on 09/06/2025 at 14:30*

> [!quote] Chapter 1
> This is your highlighted text
> 
> > [!note]
> > Your personal annotation here

🛠️ Usage:

Code:

python3 export_kobo_annotations.py

Or

Code:

python3 export_kobo_annotations.py --output ~/MyAnnotations --verbose

The script is open source and available on GitHub. It's written in Python 3 with no external dependencies - just uses the standard library.

GitHub

06-09-2025, 03:56 PM	#1
apheleia Junior Member Posts: 1 Karma: 10 Join Date: Jun 2025 Device: kobo libra colour	Kobo Annotations Exporter - Export Your Highlights & Notes to Markdown Hey everyone! 👋 I've been frustrated with the lack of good options for exporting Kobo annotations in my obsidian, so I created a Python script that automatically extracts all your highlights and notes from your Kobo eReader and exports them to a basic formatted Markdown files - one file per book. ✨ What it does: Automatically detects your Kobo database (works on macOS but not tested on Linux and Windows) Extracts all highlights and annotations from your library Exports each book's annotations to a separate Markdown file Preserves chapter/location information Creates automatic backups of existing files Shows detailed statistics about your reading habits 🔧 Features: Zero configuration needed - just plug in your Kobo and run Handles file naming conflicts intelligently Debug mode for troubleshooting Verbose output option for detailed info Clean, readable Markdown output format 📝 Sample Output: Code: # Annotations - Book Title Exported on 09/06/2025 at 14:30 > [!quote] Chapter 1 > This is your highlighted text > > > [!note] > > Your personal annotation here 🛠️ Usage: Code: python3 export_kobo_annotations.py Or Code: python3 export_kobo_annotations.py --output ~/MyAnnotations --verbose The script is open source and available on GitHub. It's written in Python 3 with no external dependencies - just uses the standard library. GitHub