MarkPane — 支持

MarkPane macOS 应用的帮助、故障排除和联系信息。

联系

电子邮件:markpane@craftclay.com

联系支持时,请包含你的 macOS 版本、MarkPane > 关于 MarkPane 中显示的 MarkPane 版本,以及对 Markdown 文件或工作流程的简要说明。发送示例文件前,请先移除其中的隐私内容。

Mac App Store 购买

MarkPane 已作为 $4.99 的 Mac App Store 付费应用提供。它是一次性付费下载, 无需订阅,也没有单独的应用内解锁。你可以从 Mac App Store 页面下载 MarkPane。

快速帮助

故障排除

我无法打开 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