README file from
GithubKindle-Transformation
Elegantly transform Kindle exported HTML notes into beautifully formatted Obsidian markdown files.
Kindle Transformation for Obsidian 📖✨
Elegantly transform your Kindle exported HTML notes into beautifully formatted Obsidian markdown files.
This plugin is designed with a focus on aesthetics, smooth user experience (UI/UX), and highly customizable note formatting.
✨ Key Features
- Drag & Drop Interface: A premium, macOS-inspired UI. Simply click or drag your Kindle
.htmlfile into the modal to instantly generate your notes. - Custom Callout Mapping: Take full control of your highlights! Map default Kindle colors (Yellow, Aqua, Pink, Orange, Blue, Green) to any Obsidian Callout type you prefer (e.g.,
quote,important,question,attention,success). - Nested Blockquotes: Highlights are automatically formatted as nested blockquotes (
> >) to create a beautiful visual hierarchy, distinguishing the book's text from your personal notes. - Smart Formatting: Automatically cleans up excessive line breaks and structurally organizes your notes by chapters.
- Auto-Routing: Specify a default folder for your imported notes. If the folder doesn't exist, the plugin will automatically create it for you.
🚀 How to Use
- Export your notes from the Kindle app (iOS/Android) to your email and download the
.htmlfile. - Open Obsidian and click the Book (📖) icon in the left ribbon (or use the Command Palette:
Run Kindle Transformation). - Drag and drop your
.htmlfile into the upload box. - Click Start Transformation. Your perfectly formatted Markdown note is ready!
⚙️ Settings
Go to Settings -> Kindle Transformation to configure:
- Save Folder: Define where your new notes should be saved (e.g.,
Reading/Kindle). Leave it blank to save in the root vault. - Callout Color Mapping: Type in your preferred Obsidian callout name for each Kindle highlight color.
🙏 Credits
This plugin is deeply inspired by and upgraded from the excellent work of l2xu/kindle_html_importer. Special thanks to the original author for providing the foundational logic for parsing Kindle HTML exports!