Stela for Mac 是一款专为 macOS 设计的现代化、轻量级写作与笔记应用。它以其极简的界面设计、流畅的 Markdown 支持和对系统原生特性的深度集成，为用户提供了一个无干扰、高效的文本创作环境。本指南将详细介绍其核心界面、完整工作流程及实用技巧。
一、核心界面与工作区详解
Stela 的界面秉承了“内容至上”的设计哲学，主要分为三个核心区域。
1.1 侧边栏（导航区）
位于窗口左侧，默认通过快捷键 ⌘Cmd + 1 显示或隐藏。包含以下部分：
- 库（Library）：按文件夹结构管理所有文档和笔记。
- 收藏（Favorites）：可快速访问标记为收藏的文档。
- 标签（Tags）：通过标签系统跨文件夹组织内容。
- 最近（Recent）：按时间顺序显示最近打开或编辑的文件。
1.2 编辑区（主工作区）
窗口中央的空白区域，是进行写作和编辑的核心地带。它提供两种核心视图：
- 编辑视图：显示纯文本和 Markdown 语法，提供语法高亮。
- 预览视图：实时渲染 Markdown 为格式化文本，通过点击工具栏的“眼睛”图标或按 ⌘Cmd + E 切换。
编辑区支持全屏和专注模式，可通过菜单栏“视图”或相应快捷键进入，以最大化写作空间。
1.3 检查器（Inspector）
位于窗口右侧，默认通过快捷键 ⌘Cmd + 3 显示或隐藏。提供当前文档的元数据管理：
- 文档属性：标题、创建/修改日期、字数统计。
- 标签管理：为当前文档添加或移除标签。
- 导出设置：快速调整导出格式的预览选项。
二、完整工作流程：从创建到导出
以下是从零开始完成一个项目并导出的标准操作流程。
2.1 创建新项目（文档）
步骤 1：启动软件并创建
打开 Stela 后，执行以下任一操作：
- 点击菜单栏 “文件” > “新建”。
- 使用快捷键 ⌘Cmd + N。
- 在侧边栏的“库”中，右键点击目标文件夹，选择“新建文档”。
步骤 2：保存与命名
首次输入内容后，建议立即保存：
- 按 ⌘Cmd + S。
- 在弹出的保存对话框中，选择位置（建议在侧边栏已建立的文件夹内），输入文件名。
- Stela 文档默认以
.md或.txt格式保存。
2.2 编辑与格式化文档
步骤 3：使用 Markdown 进行写作
在编辑区直接输入文本，并使用 Markdown 语法进行格式化：
- 标题：输入
# 一级标题，## 二级标题。 - 加粗：选中文字后按 ⌘Cmd + B，或输入
**加粗文字**。 - 列表：输入
-或*加空格创建无序列表；输入1.加空格创建有序列表。 - 实时预览：随时按 ⌘Cmd + E 在编辑和预览视图间切换，检查渲染效果。
步骤 4：组织文档结构
- 在侧边栏中，通过拖拽文档来移动位置。
- 在检查器中，为文档添加相关标签，以便于跨文件夹检索。
- 将重要文档拖入“收藏”栏，实现快速访问。
2.3 最终导出文档
步骤 5：选择导出格式与配置
- 确保目标文档处于激活状态。
- 点击菜单栏 “文件” > “导出”，或使用快捷键 ⌘Cmd + ⇧Shift + E。
- 在弹出子菜单中，选择导出格式：PDF、HTML 或 纯文本。
步骤 6：完成导出
- 系统会弹出保存对话框，让你选择导出文件的存储路径和最终文件名。
- 对于 PDF 导出，你可以在检查器的“导出设置”区域预先配置页边距、是否包含标题等选项。
- 点击“保存”即可完成。
三、常用功能进阶技巧
3.1 高效导航技巧
- 快速打开（Quick Open）：按 ⌘Cmd + O，输入文件名关键词，无需鼠标即可快速定位并打开文档。
- 在 Finder 中显示：右键点击侧边栏中的文档，选择“在 Finder 中显示”，可快速定位到文件在磁盘上的位置。
3.2 专注与排版增强
- 打字机模式：在“视图”菜单中开启，可使当前编辑行始终保持在屏幕中央，减少视线移动。
- 自定义主题：通过“Stela > 偏好设置 > 外观”，可以切换编辑区的字体、字号和颜色主题，保护视力或匹配个人喜好。
3.3 数据同步与备份
- Stela 的文档以普通文件形式保存在 Mac 上，因此可以方便地使用 iCloud Drive、Dropbox 等任何云盘服务进行文件夹同步，实现跨设备工作。
- 定期使用“文件 > 复制到…”功能，手动备份重要项目集。
四、常见问题与解决方案
问题 1：Markdown 预览显示不正常（如图片不显示、格式错乱）。
解决方案：首先检查图片路径是否为相对路径，且图片文件是否位于文档所在文件夹或其子文件夹中。确保使用正确的 Markdown 语法。尝试关闭并重新打开预览视图（⌘Cmd + E）。
问题 2：侧边栏或检查器面板意外消失。
解决方案：使用标准快捷键 ⌘Cmd + 1 切换侧边栏，⌘Cmd + 3 切换检查器。也可在“视图”菜单中确认对应面板是否被勾选。
问题 3：保存时提示“文件被锁定”或“无权限”。
解决方案：这通常是因为文件被其他程序占用，或你当前没有该文件夹的写权限。请关闭可能在后台访问该文件的其他软件（如终端、另一个编辑器），并确保文档不是保存在系统保护目录（如“桌面”或“文稿”文件夹通常没问题）。尝试“另存为”到另一个位置。
问题 4：希望恢复未保存的更改或误删的内容。
解决方案：Stela 依赖于 macOS 的自动保存和版本功能。对于已保存过的文件，可以在 Finder 中右键点击该文件，选择“浏览所有版本”，来恢复到此前的某个历史版本。对于新建未保存的文档，请及时使用保存快捷键（⌘Cmd + S）。
五、Stela for Mac 快捷键总表
| 功能分类 | 操作描述 | 快捷键 (Mac) |
|---|---|---|
| 文件操作 | 新建文档 | ⌘Cmd + N |
| 打开文档 | ⌘Cmd + O | |
| 保存文档 | ⌘Cmd + S | |
| 导出文档 | ⌘Cmd + ⇧Shift + E | |
| 编辑操作 | 撤销 | ⌘Cmd + Z |
| 重做 | ⌘Cmd + ⇧Shift + Z | |
| 查找 | ⌘Cmd + F | |
| 视图切换 | 切换编辑/预览模式 | ⌘Cmd + E |
| 切换侧边栏 | ⌘Cmd + 1 | |
| 切换检查器 | ⌘Cmd + 3 | |
| 文字格式化 | 加粗 | ⌘Cmd + B |
| 斜体 | ⌘Cmd + I | |
| 插入链接 | ⌘Cmd + K | |
| 窗口管理 | 进入/退出全屏 | ^Ctrl + ⌘Cmd + F |
通过本指南，您应能全面掌握 Stela for Mac 的核心功能与工作流。其简洁的设计旨在让您专注于创作本身，而非工具。请在实际操作中不断探索，以形成最适合自己的高效写作习惯。
