告别单调思维导图：Zotero-Better-Notes的FreeMind导出全样式自定义指南
项目地址: https://gitcode.com/gh_mirrors/zo/zotero-better-notes 你是否在使用Zotero整理文献时，导出的思维导图总是千篇一律？标题冗长、节点样式单一、内容展示混乱？本文将带你深入了解Zotero-Better-Notes中的FreeMind导出功能，通过调整核心参数实现个性化思维导图样式，让知识可视化更高效。
导出基础：认识FreeMind格式与设置界面
FreeMind是一款开源思维导图工具，其.mm格式支持丰富的节点层级与样式定义。在Zotero-Better-Notes中，通过导出窗口可快速将笔记转换为思维导图。
导出设置界面位于chrome://zotero-better-notes/content/exportNotes.xhtml，在格式选择下拉菜单中选择"FreeMind"即可启用相关配置。界面提供三种链接处理模式：
- 保留链接(keep)：维持笔记中原有的内部链接
- 嵌入内容(embed)：将链接内容直接嵌入节点
- 独立文件(standalone)：生成外部资源文件夹
核心导出逻辑实现于src/modules/export/freemind.ts，通过note2mm函数将Zotero笔记转换为FreeMind XML结构。
标题优化：控制节点文本长度与显示内容
默认导出常出现标题过长问题，可通过修改源码中字符串截断逻辑实现优化。在src/modules/export/exportWindow.ts第25行，slice(noteItems[0].getNoteTitle(), 40)控制标题最大长度为40字符。
// 原始代码：标题截断为40字符
title: fill(slice(noteItems[0].getNoteTitle(), 40), 40),
// 修改建议：增加自定义长度参数
title: fill(slice(noteItems[0].getNoteTitle(), userConfig.titleLength || 40), userConfig.titleLength || 40),
对于节点文本内容，src/modules/export/freemind.ts第58-61行处理标题HTML转义：
mmXML += `<node ID="${node.model.id}" TEXT="${htmlEscape(
Zotero.getMainWindow().document,
node.model.name || noteItem.getNoteTitle(),
)}"><hook NAME="AlwaysUnfoldedNode" />`;
可添加自定义前缀/后缀，如在标题前增加层级标识：node.model.depth + ". " + node.model.name。
内容过滤：控制节点显示范围与详略程度
思维导图的信息密度决定可读性，通过调整节点内容提取范围实现精准控制。在src/modules/export/freemind.ts第67-76行，lines.slice()控制节点内容的起止行：
lines
.slice(
node.model.lineIndex,
node.hasChildren()
? node.children[0].model.lineIndex
: node.model.endIndex + 1,
)
.join("\n"),
关键参数说明：
node.model.lineIndex：节点内容起始行号node.children[0].model.lineIndex：子节点起始行号（用于截断当前节点内容）node.model.endIndex：节点内容结束行号
修改示例：仅保留节点标题与关键引用
// 仅提取标题行与引用块
.filter(line => line.startsWith('#') || line.startsWith('>'))
样式定制：修改节点颜色与展开状态
FreeMind支持通过XML属性定义节点样式，在src/modules/export/freemind.ts第58行的node标签中添加样式属性：
<!-- 添加背景色与字体样式 -->
<node ID="${node.model.id}"
TEXT="${htmlEscape(...)}"
BACKGROUND_COLOR="${getColorByDepth(node.model.depth)}"
FONT_SIZE="${12 + node.model.depth * 2}">
节点默认展开状态由第61行的<hook NAME="AlwaysUnfoldedNode" />控制，移除该标签可恢复默认折叠状态。通过为不同层级节点分配颜色编码（如一级节点蓝色、二级节点绿色），可显著提升思维导图的层次感。
高级技巧：批量处理与自定义模板
对于需要频繁导出特定样式思维导图的用户，可通过src/modules/template/实现导出模板功能。创建FreeMind专用模板文件，定义：
- 固定的节点样式规则
- 内容过滤表达式
- 导出文件名格式
- 特殊节点处理逻辑
结合src/extras/templatePicker.ts实现模板选择界面，让样式调整无需修改代码即可完成。
完整导出流程
- 在Zotero中选中目标笔记
- 通过菜单栏「文件」→「导出笔记」打开导出窗口
- 格式选择"FreeMind"，配置链接处理模式
- 点击「确定」生成
.mm文件 - 在FreeMind中进一步调整细节样式
通过上述步骤，可将Zotero中的文献笔记转换为结构清晰、样式统一的思维导图，有效提升知识梳理效率。所有配置均可通过修改src/modules/export/freemind.ts实现持久化保存，建议修改前备份原始文件。
官方文档：docs/about-note-template.md 导出模块源码：src/modules/export/ 模板系统：src/modules/template/
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
