obsidian-plugin/tristan0929_Kindle-Transformation
1
0
Fork 0
mirror of https://github.com/tristan0929/Kindle-Transformation.git synced 2026-07-22 14:30:25 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
No description
10 commits 1 branch 6 tags 50 KiB
Find a file
Tristan0929 f3443e4f16
Add files via upload
2026-07-08 13:23:34 +08:00
LICENSE Add files via upload 2026-07-08 13:23:34 +08:00
main.js Add files via upload 2026-03-28 21:55:32 +08:00
manifest.json Update manifest.json 2026-03-28 22:20:35 +08:00
README.md Enhance README with features and usage instructions 2026-03-28 01:54:51 +08:00

README.md

Kindle-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 .html file 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

  1. Export your notes from the Kindle app (iOS/Android) to your email and download the .html file.
  2. Open Obsidian and click the Book (📖) icon in the left ribbon (or use the Command Palette: Run Kindle Transformation).
  3. Drag and drop your .html file into the upload box.
  4. 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!