联系
联系支持时,请包含你的 macOS 版本、MarkPane > 关于 MarkPane 中显示的 MarkPane 版本,以及对 Markdown 文件或工作流程的简要说明。发送示例文件前,请先移除其中的隐私内容。
Mac App Store 购买
MarkPane 已作为 $4.99 的 Mac App Store 付费应用提供。它是一次性付费下载, 无需订阅,也没有单独的应用内解锁。你可以从 Mac App Store 页面下载 MarkPane。
- 下载、购买、家人共享可用性、退款和收据处理均由 Apple 管理。
- 如果你需要在另一台 Mac 上再次安装 MarkPane,请使用同一个 Apple ID 通过 Mac App Store 安装。
- 如果 Mac App Store 要求你再次购买,请确认你已使用最初购买时的 Apple ID 登录。
快速帮助
- 完整文档:有关详细工作流程和快捷键,请参阅用户指南。
- 内置帮助:选择 帮助 > 快速帮助 (Shift-Command-/)可查看快速命令参考。
- 打开文件或文件夹:将 Markdown 文件或文件夹拖入查看器窗口,或选择 文件 > 打开 Markdown 或文件夹...(Command-O)。
- 创建 Markdown 文件:在空查看器中点击 新建 Markdown, 或在文件夹访问窗口中使用 文件夹操作 > 新建 Markdown。
- 创建文件夹:使用 文件夹操作 > 新建文件夹 在已打开文件夹的根目录创建文件夹, 或右键点击某个文件夹并选择 新建文件夹 来创建子文件夹。
- 浏览文件夹:选择一个文件夹,点击 Markdown 文件可在当前标签页中打开, Option-点击可在新标签页中打开;也可以右键点击文件和文件夹,在确认后重命名或移至废纸篓。空文件夹会保持可见且可展开。
- 使用窗口和标签页:选择 文件 > 新建窗口 (Command-N)或 文件 > 新建标签页 (Command-T)。渲染文档中的本地 Markdown 链接也可以在标签页中打开。
- 编辑当前文件:选择 文件 > 编辑当前 Markdown (Command-E)。更改会自动保存回文件;Return 会续写常见 Markdown 列表和引用, Tab 或 Shift-Tab 可缩进选中的行。
- 查找渲染内容:选择 编辑 > 在 Markdown 中查找 (Command-F),然后使用 Command-G 和 Shift-Command-G 在匹配项之间移动。
- 打印:从当前活动的查看器或编辑器窗口选择 文件 > 打印... (Command-P)。
- 排版:使用“视图”菜单选择字体、增大或减小渲染字体大小和行高,或重置排版。
- 单独打开渲染媒体:将指针悬停在图片、表格或 Mermaid 图表上, 然后点击 Open in New Window,即可使用可调整大小的独立窗口。
故障排除
我无法打开 Markdown 文件
MarkPane 接受可读的本地文本文件,包括 .md、.markdown、
.mdown、.mkd 和 .txt。如果文件不是可读文本,
或者 macOS 无法授予访问权限,MarkPane 会显示错误。请尝试将文件移动到普通的本地文件夹后重新打开。
我无法浏览文件夹
出现提示时,请选择普通的本地文件夹。MarkPane 会使用 macOS 文件夹权限来显示文件夹树, 并打开其中受支持的 Markdown 文件。隐藏文件和包内容会被跳过,非 Markdown 文件可能会以灰色显示以提供上下文。
我无法创建新的 Markdown 文件
保存面板打开时,请选择可写的本地文件夹;也可以在文件夹访问窗口中的可写文件夹内使用
新建 Markdown。MarkPane 可创建 .md、.markdown、
.mdown、.mkd 或 .txt 文件。如果文件夹为只读、
位于你授予的文件夹访问范围之外,或已包含同名项目,MarkPane 会显示错误。
我无法创建新的文件夹
请从文件夹操作菜单,或从文件夹访问窗口中的文件夹上下文菜单,使用 新建文件夹。
MarkPane 会创建一个名为 Untitled Folder 的可写文件夹,或使用下一个可用的编号名称,
然后开始行内重命名。如果父文件夹为只读、位于你授予的文件夹访问范围之外,或被 macOS 权限阻止,
MarkPane 会显示错误。
我无法重命名文件或文件夹
请在文件夹访问窗口中使用上下文菜单并选择 重命名。名称不能为空,不能包含
/,也不能与同一文件夹中的其他项目同名。如果 macOS 不允许移动,请尝试使用普通的可写本地文件夹。
我无法删除文件或文件夹
请在文件夹访问窗口中使用上下文菜单并选择 删除。MarkPane 会请求确认,然后将选中的项目移至 macOS 废纸篓。如果 macOS 不允许移动,请尝试使用普通的可写本地文件夹,或在 Finder 中调整文件权限。
链接的 Markdown 文件要求权限
如果渲染链接指向另一个本地 Markdown 文件,而该文件位于 MarkPane 已有文件夹访问权限之外, 出现提示时请选择该链接文件所在的文件夹。随后 MarkPane 会在标签页中打开链接的文档。
本地图片没有显示
由于 MarkPane 运行在沙盒中,存放在 Markdown 文件旁边的图片可能需要明确的文件夹访问权限。 请使用行内的 允许本地图片 操作,并在提示时选择该 Markdown 文件所在的文件夹。
任务列表复选框的更改没有保存
MarkPane 会直接在 Markdown 文件中更新 [ ] 和 [x] 等任务标记。
文件必须仍然可写,并且渲染出的复选框必须能够匹配源码中的任务标记。如果源码已在 MarkPane 之外发生变化,
请重新打开文件后再试。
“编辑当前 Markdown”处于禁用状态
请先打开一个 Markdown 文件。源码编辑器仅适用于有文件支持的文档,更改会自动保存回该文件。
在代码块中按 Return 不会续写列表
这是预期行为。MarkPane 会避免在围栏代码块内进行 Markdown 列表续写,以便代码示例在编辑时保持普通文本行为。
搜索结果和源码编辑器中的文本不同
在 Markdown 中查找 会搜索渲染后的文档,包括标题、表格、代码、数学公式回退文本、details 和脚注。 它的行为不同于原始源码文本搜索。
Mermaid 图表没有渲染
请确认图表位于标记为 mermaid 的围栏代码块中。MarkPane 支持 flowchart、state、sequence、
class、ER 和 XY chart Mermaid 围栏。其他图表类型或不受支持的 Mermaid 语法可能无法渲染。
数学公式没有按预期渲染
显示数学公式支持 $$...$$、\[...\] 和围栏 math 代码块。
如果 MathJax 无法渲染,某些复杂或无效的 TeX 可能会显示为可读的回退文本。
窗口透明度或玻璃表面看起来异常
使用 视图 > 窗口透明度 选择不同的不透明度,或切换 视图 > 使用玻璃文档表面。具体外观可能因 macOS 版本和系统外观而异。
超大文件的性能
超大的 Markdown 文件、复杂图表或大型数学公式区段可能需要片刻时间来解析和渲染。 如果某个文档感觉较慢,请尝试减少非常大的生成表格,或将文件拆分为较小的文档。
功能请求和反馈
请将建议发送至 markpane@craftclay.com。如有可能, 请附上一个不包含敏感信息的小型 Markdown 示例,并说明你期望看到的结果。
最后更新:2026-05-31