[Tool] Custom Kindle to Markdown Converter in python (Supports Sideloaded Books & Handwritten Notes)

Share & showcase
1

Hi everyone,

I wanted to share a small Python tool I built to convert Kindle highlights in html files to Obsidian .md files .

Why I built this? I know there are existing plugins and tools, but I found myself frustrated by a few limitations:

  1. Sideloaded Books: Many plugins rely on syncing with Amazon’s cloud, which ignores the .epub or documents I’ve sideloaded manually. This script works directly with the HTML files exported from the Kindle app.

  2. Kindle Scribe / Handwritten Notes: Most converters strip out the base64 code for images, meaning my handwritten notes and sketches from the Scribe were lost. This tool extracts them and saves them as local images linked in your notes.

  3. Aesthetics: I wanted a very specific header structure and clean look that I wasn’t getting from generic HTML-to-Markdown converters.

What it does:

  • Converts the standard HTML export from Kindle into clean Markdown.

  • Extracts Book Title as the filename.

  • Structures Chapters (#) and Sections (##) intelligently.

  • Extracts and embeds images for handwritten notes.

  • Works purely locally (no API keys or clouds required).

How to use: You just point it at your Kindle HTML exports folder, and it generates the Markdown files in your vault.
Search GitHub for: kindleHtmlNotes2Md

1 Like