Kindle Highlights — VSCode Extension

📚 Sync your Kindle highlights and notes directly into your workspace as Markdown files.

Inspired by the Obsidian Kindle Plugin.

Features

• 📥 Import from My Clippings.txt — Parse your Kindle device's clippings file to extract all highlights, notes, and bookmarks
• 📄 Markdown file generation — Each book gets its own Markdown file with all highlights
• 🔄 Smart sync — Intelligently diffs existing files, adding only new highlights without overwriting your edits
• ✏️ Nunjucks templating — Fully customizable output using the powerful Nunjucks template engine
• 👁️ Live template preview — Interactive template editor with real-time preview
• 🔍 Book browser — Beautiful sidebar panel to browse all your synced books
• ⚙️ Settings — Configure output folder, file naming, and more

Getting Started

Method A: Sync from Amazon Cloud (Recommended)

1. Open your browser and log in to Amazon Kindle Notebook (or your region's equivalent like read.amazon.com/notebook).
2. Open Developer Tools (F12 or Ctrl+Shift+I).
3. Go to the Network tab and refresh the page.
4. Click on the very first request (usually notebook) and scroll down to Request Headers.
5. Copy the entire value of the cookie: field (it starts with session-id=...).
6. In VSCode, open settings (Ctrl+,) and search for Kindle Highlights: Amazon Cookie.
7. Paste the cookie there and set your Amazon Region.
8. Run the command: "Kindle Highlights: Sync from Amazon Cloud".

Note on Cookie Lifespan & Future Syncs: You only need to set the cookie once. As long as the cookie is valid (usually several months), you can just run the sync command to automatically fetch any newly read books and new highlights without updating the cookie. You will only need to get a new cookie if you explicitly log out of Amazon in your browser, change your password, or if the cookie naturally expires.

【Cookieの有効期限と自動同期について】 Cookieを設定するのは最初の1回だけでOKです。Cookieが有効な期間（通常は数ヶ月間）は、同期コマンドを実行するだけで新しく読んだ本や新しいハイライトが自動的に追加同期されます。 ブラウザから手動でログアウトした、パスワードを変更した、またはCookieの期限が切れた場合にのみ、再度Cookieを取り直して設定を更新してください。

Method B: Sync via My Clippings.txt

1. Connect your Kindle device to your computer via USB.
2. Navigate to the documents folder on your Kindle.
3. Find and copy My Clippings.txt.
4. Run the command: "Kindle Highlights: Sync from My Clippings.txt".
5. Select your My Clippings.txt file.

Find your Markdown files

Your highlights will be saved to the folder specified in settings (default: C:\obsidian\00_note\02_book).

Template System

Templates use Nunjucks syntax.

Available Variables

Highlight Object Properties

Example Template

---
title: "{{ title }}"
author: "{{ author }}"
date: "{{ lastAnnotatedDate | date("YYYY-MM-DD") }}"
highlights: {{ highlightsCount }}
---

# {{ title }}
by {{ author }}

{% for highlight in highlights %}
> {{ highlight.text }}

{% if highlight.note %}**Note:** {{ highlight.note }}

{% endif %}
*Location: {{ highlight.location }}*

---
{% endfor %}

Settings

Commands

Development

# Install dependencies
npm install

# Compile TypeScript
npm run compile

# Watch mode
npm run watch

Press F5 in VSCode to launch the extension in a new Extension Development Host window.

License

MIT