How do I install the Kindle2md skill?

Run npx skillmds@latest add knownasnaffy/kindle2md-3 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Kindle2md safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Kindle2md?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Kindle2md free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Kindle2md?

knownasnaffy (@knownasnaffy) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Kindle2md by knownasnaffy — Agent Skill

Name: Kindle2md
Author: knownasnaffy

Kindle2md

Convert Kindle HTML notebook exports to Obsidian Markdown format. Use this when the user wants to convert a Kindle book notes HTML file (exported from the Kindle app) into a Markdown file suitable for Obsidian. Trigger when user mentions "kindle", "读书笔记", "Kindle笔记", "笔记本.html", or wants to convert book highlights to markdown.

knownasnaffy Updated Sep 21, 2026 0 repo stars

File contents

Helper Behavior Review

python scripts/_main.py is an optional helper whose behavior should be compared with this skill's documented purpose before use. Show what the script does, explain any mismatch with the user-facing description, and run it only when the user explicitly wants that diagnostic path.

Kindle to Markdown

Use this skill to convert Kindle HTML notebook exports to Obsidian Markdown format.

Setup (First Time Only)

Before using, configure the output directory by editing references/config.md.

Read references/config.md to get the output_dir value. If the value is still "CHANGE_TO_YOUR_OBSIDIAN_BOOKS_PATH", remind the user to configure it first.

Input

The user will provide an HTML file path, for example:

/kindle2md "下载/动物农场.html"
/kindle2md "C:/Users/Downloads/动物农场 (Z-Library) - 笔记本.html"

Extract the book title from the HTML filename:

Remove path and extension
Remove metadata like "[英]作者", "(Z-Library)", " - 笔记本"

Output

Output directory: Read from references/config.md → output_dir

Output filename: {书名}.md

Example: for input file 动物农场 ([英]乔治·奥威尔) (Z-Library) - 笔记本.html, output should be 动物农场.md

If file already exists, overwrite it.

Runtime

Run the conversion script from the scripts folder:

python "<skill_path>/scripts/kindle_notes_to_md.py" --override -o "<output_dir>/<书名>.md" "<用户提供的HTML路径>"

Where:

<skill_path> is the path to this skill folder
<output_dir> is read from references/config.md

Success

Report to the user:

"转换完成！文件已保存到: {output_path}"

Errors

If the HTML file doesn't exist or is invalid, report the error to the user clearly.

---name: kindle2md-3description: Convert Kindle HTML notebook exports to Obsidian Markdown format. Use this when the user wants to convert a Kindle book notes HTML file (exported from the Kindle app) into a Markdown file suitable for Obsidian. Trigger when user mentions "kindle", "读书笔记", "Kindle笔记", "笔记本.html", or wants to convert book highlights to markdown.---### Helper Behavior Review`python scripts/_main.py` is an optional helper whose behavior should be compared with this skill's documented purpose before use. Show what the script does, explain any mismatch with the user-facing description, and run it only when the user explicitly wants that diagnostic path.# Kindle to MarkdownUse this skill to convert Kindle HTML notebook exports to Obsidian Markdown format.## Setup (First Time Only)Before using, configure the output directory by editing `references/config.md`.**Read `references/config.md`** to get the `output_dir` value. If the value is still "CHANGE_TO_YOUR_OBSIDIAN_BOOKS_PATH", remind the user to configure it first.## InputThe user will provide an HTML file path, for example:- `/kindle2md "下载/动物农场.html"`- `/kindle2md "C:/Users/Downloads/动物农场 (Z-Library) - 笔记本.html"`Extract the book title from the HTML filename:- Remove path and extension- Remove metadata like "[英]作者", "(Z-Library)", " - 笔记本"## Output**Output directory**: Read from `references/config.md` → `output_dir`**Output filename**: `{书名}.md`Example: for input file `动物农场 ([英]乔治·奥威尔) (Z-Library) - 笔记本.html`, output should be `动物农场.md`If file already exists, overwrite it.## RuntimeRun the conversion script from the scripts folder:```bashpython "<skill_path>/scripts/kindle_notes_to_md.py" --override -o "<output_dir>/<书名>.md" "<用户提供的HTML路径>"```Where:- `<skill_path>` is the path to this skill folder- `<output_dir>` is read from `references/config.md`## SuccessReport to the user:- "转换完成！文件已保存到: {output_path}"## ErrorsIf the HTML file doesn't exist or is invalid, report the error to the user clearly.

Frequently asked questions