MarkMyWords 是一款专为 macOS 设计的轻量级、高性能 Markdown 编辑器。它以其极简的界面、实时预览功能和对原生 macOS 特性的深度集成而著称，旨在为用户提供无干扰、流畅的 Markdown 写作与编辑体验。本指南将详细介绍其核心功能与完整工作流程。

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

MarkMyWords 采用经典的双栏布局，主界面清晰直观，主要分为以下几个区域：

提示：您可以通过拖动中央的分隔条来调整编辑区与预览区的相对宽度，也可以通过菜单栏的“视图”>“仅编辑器”或“仅预览”来切换单栏模式，实现全神贯注的写作或审阅。

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

步骤 1：启动软件。在 Launchpad 或应用程序文件夹中点击 MarkMyWords 图标。

步骤 2：创建新文档。启动后，软件通常会自动创建一个新的空白文档。您也可以通过以下方式创建：

步骤 3：打开现有文档。要打开已有的 Markdown (.md, .markdown, .txt) 文件：

在左侧编辑区直接输入文本。使用 Markdown 语法进行格式化：

您也可以使用工具栏按钮或快捷键（见下文表格）快速插入格式，而无需记忆语法。

在您输入的同时，右侧预览区会自动更新。利用此功能检查格式是否正确，文档结构是否清晰。

进阶技巧：如果文档包含本地图片，请确保使用相对路径（如 ![图片说明](./images/photo.png)）。预览区将正确显示位于项目文件夹内的图片。

步骤 1：首次保存。

在弹出窗口中指定文件名、保存位置，并确保保存类型为“Markdown 文件 (*.md)”或其他文本格式。

步骤 2：后续保存。编辑过程中，建议经常使用 Command + S 快速保存，防止内容丢失。

MarkMyWords 支持将编辑好的 Markdown 文档导出为多种格式。

步骤 1：选择导出格式。点击菜单栏的 文件 > 导出为，您将看到可选格式：

步骤 2：配置与导出。选择格式（如 PDF）后，会弹出保存对话框。您可以为导出文件命名并选择存储位置，然后点击“保存”。软件将使用内置引擎完成格式转换并生成文件。

自定义 CSS 样式：导出的 HTML 文件可以应用自定义 CSS 来改变外观。您可以在菜单栏的 MarkMyWords > 偏好设置... 中找到相关选项，链接或编写自己的 CSS 文件。
切换解析器：在状态栏右侧，可以点击当前解析器名称（如“CommonMark”）来切换不同的 Markdown 解析引擎（如 GitHub Flavored Markdown），以适应不同的语法标准。
文档统计：状态栏实时显示的字符、单词和行数统计，是评估写作进度的实用工具。
深色模式适配：MarkMyWords 完美支持 macOS 的深色模式。当系统切换至深色模式时，编辑器和预览区的主题会自动切换，保护视力。
直接拖拽插入图片：将 Finder 中的图片文件直接拖拽到编辑区的指定位置，软件会自动生成正确的 Markdown 图片链接语法。

问题 1：预览区图片无法显示

解决方案：检查图片路径。如果使用绝对路径（以“/”开头），在其他环境可能失效。建议将图片放在与 Markdown 文件相同的目录或子目录下，并使用相对路径引用。确保图片文件名和路径中不包含特殊字符或空格。

问题 2：导出的 PDF/HTML 格式不符合预期

解决方案：首先在软件的预览区确认渲染是否正确。如果预览正确但导出异常，可能是由于自定义 CSS 冲突或导出引擎限制。尝试使用默认设置导出，或检查并调整自定义 CSS 样式规则。

问题 3：某些 Markdown 扩展语法不被支持

解决方案：点击状态栏的解析器名称，尝试切换到“GitHub Flavored Markdown”或其他支持更多扩展语法的解析器。请注意，不同解析器对语法的支持程度有差异。

问题 4：软件意外退出或卡顿

解决方案：确保您的 macOS 系统已更新至较新版本。如果文档过大（如超过数万字），可能会影响性能。尝试将大文档拆分为几个小文件。重启软件通常可以解决临时性卡顿。