Whisk for Mac 是一款专注于高效文本编辑与笔记管理的原生 macOS 应用。它以其极简的设计、强大的 Markdown 支持、闪电般的响应速度以及深度集成 macOS 系统特性（如 Spotlight、快捷指令）而著称，旨在为用户提供一个无干扰、沉浸式的写作与代码片段管理环境。

一、核心界面与工作区详解

Whisk 的界面秉承“内容至上”的理念，布局清晰，主要分为以下几个区域：

侧边栏（导航栏）：位于窗口左侧。顶部为“收藏夹”和“标签”筛选区，中部为文件夹目录树，清晰展示所有笔记和文档的层级结构。底部是全局搜索框和设置入口。
文档列表区：位于侧边栏右侧。显示当前选中文件夹内的所有文档列表，支持按名称、修改日期等排序。列表项会预览文档的首行内容。
编辑与预览工作区：窗口的主体部分。默认采用“实时预览”模式，左侧为 Markdown 源码编辑区，右侧为即时渲染的预览区。用户可以通过工具栏按钮或快捷键在“纯编辑”、“纯预览”和“分栏”模式间切换。
状态栏：位于窗口底部。显示当前文档的字数、行数、光标位置等信息，以及文档的语法类型（如 Markdown, Plain Text, 代码语言）选择器。
工具栏：位于窗口顶部（可隐藏）。提供最常用的操作按钮，如新建文档、保存、切换视图、插入常用 Markdown 格式等。

二、完整操作流程：从创建到导出

创建新文档：

新建的文档会立即在编辑区打开，并处于待命名状态。

打开现有文档：

在编辑区直接输入内容。Whisk 支持标准 Markdown 语法和 GitHub Flavored Markdown (GFM)。

插入标题：在行首输入1-6个#后跟空格，或使用快捷键 Command + 1 至 6。
加粗/斜体：选中文本，使用快捷键 Command + B (加粗) 或 Command + I (斜体)。
插入列表：行首输入 - 或 * 或 1. 后跟空格。按 Return 自动生成下一项，按 Tab 缩进为子列表。
插入代码块：输入三个反引号 ``` 后按 Return，或使用快捷键 Command + Option + C。可在状态栏选择具体编程语言以实现语法高亮。

重命名文档：在侧边栏或文档列表中慢速双击文档名称，或选中后按 Enter 键。

移动文档：在侧边栏或文档列表中，拖拽文档至目标文件夹。

添加标签：在编辑区顶部的元数据区域或文档信息面板中输入标签，格式为 #标签名。多个标签以空格分隔。

Whisk 采用自动保存机制，所有更改都会实时保存到文件所在位置。手动保存操作主要用于“另存为”：

Whisk 支持将文档导出为多种格式。

多文档同时编辑：可以将文档标签页拖出主窗口，创建独立的窗口，实现分屏操作。
快速跳转：使用快捷键 Command + Option + O 调出“快速打开”面板，输入文件名或内容片段即可快速定位并打开文档。
专注模式：点击工具栏的“眼睛”图标或使用快捷键 Command + Option + F 可以隐藏侧边栏和文档列表区，进入全屏沉浸式写作模式。
自定义主题：在“偏好设置” -> “外观”中，可以分别为编辑器和预览区选择不同的颜色主题和字体，打造个性化工作环境。
与系统深度集成：Whisk 的文档可通过 Spotlight 直接搜索内容。其“快速笔记”功能可通过配置系统“快捷指令”，实现全局快捷键快速呼出一个小型笔记窗口。

Q1: 预览区的图片无法显示？

A: 请检查图片路径。如果使用相对路径，请确保图片文件与 .md 文档的相对位置正确，或将其放入 Whisk 管理的资源文件夹内。绝对路径需保证文件存在。

Q2: 文档在 Whisk 和其他编辑器中显示效果不一致？

A: 这是由于不同软件对 Markdown 标准的解释和 CSS 渲染样式不同所致。Whisk 的预览样式可以在设置中调整。对于需要严格一致性的场景，建议导出为 PDF 或 HTML 等固定格式。

Q3: 快捷键冲突或无响应？

A: 首先检查是否在编辑文本输入状态。部分系统级快捷键（如输入法切换）可能优先。可以在 Whisk 的“偏好设置” -> “快捷键”中查看和修改所有快捷键绑定。

Q4: 如何找回未保存就关闭的文档？

A: Whisk 有自动保存功能，常规编辑关闭后重新打开即可。如果是未命名的全新文档，请检查“文件”菜单下的“打开最近使用”中是否有“恢复的文档”条目。