@jwbz/etom

EPUB to Obsidian Markdown 转换工具。自动从豆瓣抓取书籍元数据和封面，生成干净的 Markdown 笔记。

安装

npm install -g @jwbz/etom

使用

# 转换单个 epub
etom book.epub

# 批量转换目录下所有 epub
etom ./epubs/

# 使用默认目录（booksDir 配置）
etom

# 跳过豆瓣抓取
etom book.epub --no-douban

配置

在项目目录下创建 .etomrc.json：

{
  "vault": "E:/Obsidian/你的仓库",
  "booksDir": "E:/Obsidian/你的仓库/书库",
  "imagesDir": "E:/Obsidian/你的仓库/CONFIG/BOOK"
}

| 字段 | 说明 | |---|---| | vault | Obsidian 仓库根目录，用于计算 wikilink 相对路径 | | booksDir | epub 文件存放目录（批量模式默认输入 + Markdown 输出） | | imagesDir | 图片输出目录（封面和内嵌图片） |

输出

• Markdown 文件：输出到 booksDir 目录，文件名为书名
• 图片：提取到 {imagesDir}/{书名}/ 目录
• 封面：从豆瓣下载到 {imagesDir}/{书名}/cover.jpg

YAML Frontmatter

---
title: 生存的艺术
tags:
  - book
cover: CONFIG/BOOK/生存的艺术/cover.jpg
author: "[古希腊] 爱比克泰德"
translator: 周文心
publisher: 湖南文艺出版社
publicationYear: 2024
ISBN: 9787572620782
bookReview: ""
top: false
relationshipDiagram: false
readingDate: null
completionDate: null
doubanRating: 8.8
doubanUrl: https://book.douban.com/subject/37053489/
pages: 320
price: 59
producer: 浦睿文化
binding: 平装
originalTitle: The Art of Living
series: 尤里卡文库
---

功能

• epub → Markdown 转换（纯 JS，无需 pandoc）
• 豆瓣书籍搜索（ISBN 优先 → 书名+作者 降级搜索）
• 豆瓣详情页解析（评分、简介、页数、价格等）
• 封面图片自动下载
• Markdown 格式清理（去 HTML 标签、修逐字加粗）
• 脚注规范化（[^n] 格式，全局连续编号）
• 图片本地化 + Obsidian wikilink 路径