WonderPen（妙笔）是一款专为写作者设计的Mac平台Markdown写作软件。它集成了文档管理、大纲组织、沉浸式写作与多格式导出等功能，旨在提供一个专注、高效且结构清晰的创作环境。本文将深入解析其界面、完整工作流程及进阶技巧。
一、核心界面与工作区详解
启动WonderPen后，主界面主要分为四个核心区域，共同构成了一个高效的三窗格写作环境。
- 左侧导航栏（项目树）：位于窗口最左侧，以树状结构管理所有文档和文件夹。您可以在此创建项目、章节和文档，并通过拖拽进行重组。
- 中间文档列表/大纲视图：位于导航栏右侧。默认显示当前选中文件夹下的文档列表。点击顶部工具栏的“大纲”图标（或使用快捷键
Cmd+2）可切换至“大纲视图”，以层级卡片形式展示文档结构，方便快速调整内容顺序。 - 右侧编辑区：软件的主体区域，采用类IDE的标签页设计。支持Markdown语法实时预览（分屏或混排模式），并提供字数统计、段落导航等辅助功能。
- 右侧边栏（检查器）：编辑区右侧可滑出的面板（快捷键
Cmd+Option+I）。包含“文档信息”（字数、修改时间等）、“全局替换”、“文档导出”和“主题设置”等工具。
二、从创建到导出的完整操作流程
1. 创建或打开项目
步骤一：新建项目 点击菜单栏 “文件” -> “新建项目”（快捷键 Cmd+Shift+N），在弹出的对话框中输入项目名称并选择存储位置。一个项目即一个独立的写作集合。
步骤二：新建文档/文件夹 在左侧导航栏选中目标位置，点击顶部工具栏的“新建”按钮（或右键菜单），选择“新建文档”（Cmd+N）或“新建文件夹”。文档支持Markdown格式。
2. 组织与撰写内容
步骤三：使用大纲视图规划结构 在导航栏选中一个文件夹或项目根目录，点击工具栏“大纲”图标（Cmd+2）。在此视图中，您可以：
- 通过拖拽卡片调整文档顺序。
- 右键卡片，选择“降级”或“升级”以创建层级关系。
- 双击卡片标题快速重命名。
步骤四：在编辑区进行写作 双击导航栏或大纲中的文档，在右侧编辑区打开。
- 模式切换：点击编辑区右上角的“预览”按钮（或按
Cmd+4）可在“纯编辑”、“实时预览”（左右分屏）和“专注模式”（隐藏其他窗格）间切换。 - 基础写作：直接输入Markdown语法（如
# 标题，**加粗**），软件会实时渲染格式。
3. 修订与整理
步骤五：利用检查器与工具 唤出右侧边栏（Cmd+Option+I）。
- 在“文档信息”中查看统计数据。
- 使用“全局替换”功能，可在当前打开文档或整个项目范围内进行查找替换。
步骤六：文档内部导航 长按编辑区右下角的“段落导航”按钮，或使用快捷键 Ctrl+Shift+O，可以快速跳转到文档的任意标题段落。
4. 最终导出
步骤七：导出文档 确保目标文档处于激活状态，有以下几种方式：
- 快速导出：菜单栏选择 “文件” -> “导出”，然后选择格式（如PDF、Word、HTML、纯文本等）。
- 通过检查器导出：在右侧边栏的“导出”选项卡中，提供更详细的格式设置（如PDF的页眉页脚、Word的模板），设置完成后点击“导出”按钮。
- 快捷键：导出为PDF的快捷键是
Cmd+Option+E。
三、常用功能进阶技巧
- 多文档同时编辑：在标签栏拖动文档标签页，可将其分离为独立窗口，实现双屏或多屏对照写作。
- 快速聚焦与隐藏：按下
Cmd+Option+F可进入“超级专注模式”，隐藏除当前编辑段落外的所有内容；再按一次恢复。 - 版本快照：在检查器的“文档信息”中，可以手动为重要文档创建“快照”，用于备份关键版本，便于回溯。
- 自定义主题：在右侧边栏的“主题”选项卡中，不仅可以切换预设的编辑器和预览主题，还能自定义CSS，实现预览样式的个性化。
- 项目内链接：使用
[[文档标题]]语法可以快速创建到项目内其他文档的链接，构建知识网络。
四、常见问题与解决方案
Q1: 大纲视图中的文档顺序乱了，如何快速整理？
解决方案：在大纲视图中，直接拖拽卡片即可调整顺序。如需按文件名、创建时间等规则排序，可点击大纲视图顶部的“排序”按钮选择排序规则。
Q2: 从其他软件粘贴过来的文本格式错乱。
解决方案：粘贴时使用 “编辑” -> “粘贴并匹配样式”（快捷键 Cmd+Shift+Option+V），或先粘贴到纯文本编辑器（如TextEdit）中清除格式，再复制到WonderPen。
Q3: 实时预览模式下，图片无法显示。
解决方案：首先确认Markdown图片语法正确 。如果是本地图片，请确保使用的是相对路径，并且图片文件位于项目文件夹内或指定的资源文件夹中。
Q4: 如何快速查找项目中的所有特定关键词？
解决方案：使用右侧边栏的“全局替换”功能，或使用菜单栏 “编辑” -> “查找” -> “在项目中查找”（快捷键 Cmd+Shift+F）。
五、WonderPen for Mac 快捷键汇总表
| 功能分类 | 操作描述 | 快捷键 (Mac) |
|---|---|---|
| 文件与项目 | 新建项目 | Cmd + Shift + N |
| 新建文档 | Cmd + N |
|
| 保存当前文档 | Cmd + S |
|
| 导出为PDF | Cmd + Option + E |
|
| 视图切换 | 切换至大纲视图 | Cmd + 2 |
| 切换至文档列表视图 | Cmd + 1 |
|
| 切换至实时预览模式 | Cmd + 4 |
|
| 显示/隐藏右侧检查器 | Cmd + Option + I |
|
| 编辑与导航 | 查找（当前文档） | Cmd + F |
| 在项目中查找 | Cmd + Shift + F |
|
| 粘贴并匹配样式 | Cmd + Shift + Option + V |
|
| 快速打开（跳转到标题） | Ctrl + Shift + O |
|
| 进入/退出超级专注模式 | Cmd + Option + F |
|
| 格式操作 | 加粗 | Cmd + B |
| 斜体 | Cmd + I |
|
| 插入链接 | Cmd + K |
