Textbundle Editor 是一款专为 macOS 设计的轻量级、专注于内容的文本编辑器。其核心特色在于原生支持 Textbundle 和 Textpack 格式，这两种格式能够将 Markdown 文本、图片、附件等资源打包成一个独立的文件，极大地方便了内容的管理与分享。它完美融合了纯文本编辑的简洁与富媒体内容的便利，是作家、笔记爱好者、博客作者和开发者的理想工具。
一、核心界面与工作区详解
启动 Textbundle Editor 后，您将看到一个简洁而功能分区明确的主界面。整个工作区主要分为四个核心部分：
- 顶部菜单栏与工具栏：包含所有文件操作、编辑命令、视图切换及偏好设置的入口。工具栏可自定义，常用操作如切换预览模式、导出等可在此快速访问。
- 左侧导航边栏（如果启用）：在打开包含多个文件的 Textpack 或文件夹时，此处会显示文件树状列表，方便在不同文档间快速切换。
- 中央编辑与预览区：这是最主要的工作区域。
- 编辑模式：显示纯文本源码，支持 Markdown、HTML 等语法高亮。
- 预览模式：实时渲染 Markdown 格式，显示最终排版效果，包括内嵌的图片和链接。
- 您可以通过工具栏按钮或快捷键在两种模式间无缝切换。
- 右侧检查器面板（如果启用）：显示当前文档的元数据（如标题、标签、创建日期）和附件列表。您可以在此管理打包在 Textbundle 文件中的所有资源。
二、完整操作流程：从创建到导出
1. 创建新项目（文档）
操作步骤：
- 启动 Textbundle Editor。
- 点击菜单栏 “文件” (File) -> “新建” (New)，或直接使用快捷键
Command + N。 - 此时会创建一个未命名的、包含基础结构的 Textbundle 文档，并自动进入编辑模式。
- 如需指定格式，可在“新建”子菜单中选择“新建 Textbundle”或“新建 Textpack”（后者适用于多文件项目）。
2. 打开现有项目
操作步骤：
- 点击菜单栏 “文件” (File) -> “打开” (Open)，或使用快捷键
Command + O。 - 在文件选择对话框中，导航至您的
.textbundle或.textpack文件，选中并点击“打开”。 - 软件会自动解包并显示主文本内容，所有关联资源都可在右侧检查器面板中查看。
3. 编辑与内容组织
操作步骤：
- 在中央编辑区直接输入或修改文本。支持标准的 Markdown 语法（如
# 标题，**粗体**，- 列表）。 - 插入图片或附件：
- 将文件直接拖拽到编辑器的编辑窗口，软件会自动将其复制到 Textbundle 的资源文件夹，并插入正确的 Markdown 引用链接。
- 或使用菜单栏 “插入” (Insert) -> “图片” (Image) 来选择文件。
- 随时使用
Command + R或点击工具栏的“眼睛”图标，切换到预览模式查看实时渲染效果。
4. 保存项目
操作步骤：
- Textbundle Editor 会自动保存对文档内容的更改。
- 对于“另存为”操作，点击菜单栏 “文件” (File) -> “另存为…” (Save As…)，或使用快捷键
Command + Shift + S。 - 在对话框中指定文件名和保存位置，软件会将文本和所有用到的资源打包成
.textbundle文件。
5. 导出最终文档
操作步骤：
- 点击菜单栏 “文件” (File) -> “导出” (Export)。
- 在子菜单中选择您需要的格式，如 HTML、PDF、纯文本 或 富文本 (RTF)。
- 系统会弹出保存对话框，选择导出文件的存放路径和名称，点击“导出”。
- 在导出过程中，所有内嵌资源（如图片）都会被正确处理并链接到输出文件中。
三、常用功能进阶技巧
- 分栏编辑：同时打开编辑模式和预览模式，实现真正的“所见即所得”。通过菜单栏 “视图” (View) -> “启用分栏” (Enable Split View) 或使用快捷键
Command +来开启左右分栏视图。 - 文档元数据管理：在右侧检查器面板中，可以方便地编辑文档的标题、作者、标签等元信息。这些信息会保存在 Textbundle 的
info.json文件中。 - 快速资源定位：在预览模式下，按住
Command键并点击图片，可以在 Finder 中直接定位到该资源文件在 Textbundle 包内的位置。 - 纯文本专家模式：对于追求纯粹键盘操作的用户，可以专注于编辑区，使用丰富的文本导航快捷键（如
Command + 方向键跳转至行首/行尾/文档头/文档尾）来提升效率。
四、常见问题与解决方案
Q1: 我收到了一个 .textbundle 文件，但在 Finder 中它显示为一个“包”，我该如何查看里面的内容？
A1: 在 Finder 中，右键点击该文件，选择“显示包内容”，即可浏览内部的文本文件（通常是 text.md）和 assets 资源文件夹。但为了获得最佳编辑体验，强烈建议使用 Textbundle Editor 来打开它。
Q2: 在编辑模式下插入的图片链接，为什么在预览模式下无法显示？
A2: 请确保图片是通过拖拽或“插入”菜单的方式添加到文档中的。手动输入的本地文件路径（如 ~/Pictures/photo.jpg）不会被自动复制到 Textbundle 包内。正确的做法是使用拖拽功能，编辑器会自动生成类似  的相对路径。
Q3: 导出的 PDF 或 HTML 文件样式不符合预期，如何调整？
A3: Textbundle Editor 使用内置的、相对固定的模板进行导出。要深度自定义输出样式，您需要修改或创建自定义的 CSS（用于HTML导出）或模板文件。这通常需要一定的前端知识，相关设置选项位于软件的“偏好设置”中。
Q4: 软件突然无响应或编辑内容未自动保存？
A4: 首先，Textbundle Editor 的自动保存机制通常很可靠。如果遇到无响应，请尝试等待片刻，或使用 macOS 的“强制退出”（Command + Option + Esc）。重启软件后，它通常会尝试恢复上次的会话。为防万一，养成定期使用 Command + S 手动保存的习惯总是好的。
五、Mac版快捷键汇总表
| 功能分类 | 操作描述 | 快捷键 (Mac) |
|---|---|---|
| 文件操作 | 新建文档 | Command + N |
| 打开文档 | Command + O |
|
| 保存 | Command + S |
|
| 另存为 | Command + Shift + S |
|
| 编辑操作 | 撤销 | Command + Z |
| 重做 | Command + Shift + Z |
|
| 查找 | Command + F |
|
| 视图切换 | 切换编辑/预览模式 | Command + R |
| 启用/关闭分栏视图 | Command + |
|
| 切换检查器面板 | Command + Option + I |
|
| 文本导航 | 跳转到行首 | Command + ← |
| 跳转到行尾 | Command + → |
|
| 跳转到文档开头 | Command + ↑ |
|
| 跳转到文档结尾 | Command + ↓ |
|
| 格式应用 | 加粗选中文本 | Command + B |
| 其他 | 导出文件 | Command + E |
