Byte-n · May 7, 2026 · May 7, 2026 · May 7, 2026 · May 7, 2026
diff --git a/.gitignore b/.gitignore
@@ -11,3 +11,4 @@ larkDocx2mdOutput/
 # idea
 .qoder
 .agents
+coverage
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.5.0
+
+### Features
+
+- **按标题过滤文档内容**：新增 `--filter-title` CLI 参数与 `ConvertOptions.filterTitle` 选项，仅输出指定标题所在章节的内容
+
+### Fixed
+
+- **filterTitle 入参容错**：对 `filterTitle` 应用 `trim()`，避免空白字符导致匹配失败
+
 ## 0.3.2
 
 ### Changed

diff --git a/README.md b/README.md
@@ -4,7 +4,13 @@
 
 将飞书文档、电子表格转换为 Markdown 文件的命令行工具。
 
-> 支持的飞书文档链接格式：`https://*.feishu.cn/wiki/*`、`https://*.feishu.cn/sheets/*`（支持 `?sheet=<sheetId>` 指定子表）
+
+支持：
+- 飞书文档：`https://*.feishu.cn/wiki/*`
+  - Markdown 类型中的标题、列表、基础文字等常见的文本样式
+  - 飞书文档中的内嵌画板、电子表格
+  - ...见下表‘支持的内容块类型’
+- 飞书电子表格：`https://*.feishu.cn/sheets/*`（支持 `?sheet=<sheetId>` 指定子表）、`https://*.feishu.cn/wiki/*`
 
 ## 使用
 

diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "lark-docx2md",
-  "version": "0.3.2",
+  "version": "0.5.0",
   "description": "Convert Lark/Feishu documents to Markdown",
   "type": "module",
   "main": "./dist/converter.js",
@@ -15,6 +15,9 @@
   "scripts": {
     "build": "tsdown",
     "dev": "tsx src/cli.ts",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:coverage": "vitest run --coverage",
     "prepack": "pnpm build"
   },
   "keywords": [
@@ -44,9 +47,11 @@
   },
   "devDependencies": {
     "@types/node": "^25.5.2",
+    "@vitest/coverage-v8": "^4.1.5",
     "ts-node": "^10.9.2",
     "tsdown": "^0.12.9",
     "tsx": "^4.21.0",
-    "typescript": "^6.0.2"
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.5"
   }
 }
-Original file line number
+Diff line change
@@ Expand Up / @@ -11,3 +11,4 @@ larkDocx2mdOutput/ @@
     # idea
     .qoder
     .agents
+    coverage