MarkText 开源 Markdown 编辑器全面指南核心特性、跨平台安装与源码构建【免费下载链接】marktextA simple and elegant markdown editor, available for Linux, macOS and Windows.项目地址: https://gitcode.com/gh_mirrors/ma/marktext本文基于仓库内西班牙语官方文档 docs/i18n/README-es.md 整理编写并结合仓库源码、打包配置与开发者文档进行补充。MarkText 是一款面向 Linux、macOS 与 Windows 的开源 Markdown 编辑器主打所见即所得WYSIWYG的实时预览、简洁优雅的界面与流畅的写作体验。读完本文你将掌握 MarkText 的全部核心特性、三大平台的安装与卸载方法、主题切换机制以及从源码自行构建应用的完整流程。MarkText 是什么新一代 Markdown 编辑器MarkText 是一个开源的下一代 Markdown 编辑器其定位是简单而优雅并且专注于速度与易用性focused on speed and usability。它由 Jocs当前仓库版本为0.20.0-dev见 package.json。项目以 pnpm monorepo 形式组织核心构成包括packages/desktop基于 Electron 的桌面应用主程序负责窗口管理、菜单、偏好设置与文件系统packages/muyaMarkdown 渲染引擎muyajs/core负责将 Markdown 解析为块级 DOM 并实现 WYSIWYG 实时预览packages/website官方文档与官网站点源码。在渲染能力上MarkText 内部集成了katex数学公式、mermaid、flowchart.js、plantuml图表、prismjs代码高亮、turndown与joplin-turndown-plugin-gfmMarkdown 导出等关键依赖见 packages/desktop/package.json从依赖层面即可看出其完整的 Markdown 生态支持。核心功能特性根据官方文档MarkText 的核心特性可以归纳为以下几个方面实时预览WYSIWYG与无干扰写作MarkText 提供实时预览What You See Is What You Get能力界面干净、简洁让作者获得无干扰的写作体验。与传统左侧源码、右侧预览的双栏编辑器不同MarkText 将渲染结果直接呈现在编辑区标题、列表、表格等以最终形态实时呈现。标准语法兼容与扩展语法兼容 CommonMark Spec 规范兼容 GitHub Flavored Markdown SpecGFM规范选择性支持 Pandoc markdown 语法支持多种 Markdown 扩展语法包括数学公式KaTeX、front matter前置元数据与emoji 表情。仓库中packages/muya引擎的src/state目录下提供了markdownToState.ts、stateToMarkdown.ts、htmlToMarkdown.ts、markdownToHtml.ts等核心转换实现见 packages/muya/src/state配套的test/spec/commonmark.spec.ts与gfm.spec.ts则承担了规范符合性的回归验证。段落与行内样式快捷键MarkText 支持段落级与行内样式级快捷键帮助提升写作效率例如快速设置标题级别、加粗、斜体、代码块、引用、列表等。行内格式的完整快捷键定义可参考 packages/desktop/src/main/keyboard/keybindingsLinux.ts 等平台绑定文件。导出 HTML 与 PDF文档可直接导出为HTML与PDF文件满足分享与打印需求。仓库的端到端测试中包含 export-pdf.spec.ts用于验证 PDF 导出流程。多主题与多编辑模式多种主题内置包括Cadmium Light默认浅色、Material DarkMaterial 风格深色在内的 33 款主题涵盖浅色与深色两大类多种编辑模式源码模式Source Code mode、打字机模式Typewriter mode与专注模式Focus mode分别满足查看 Markdown 源码、居中光标打字、弱化非当前段落等不同写作场景。主题的完整清单与切换方式参见 packages/website/content/docs/end-user/THEMES.md。剪贴板直接粘贴图片支持从系统剪贴板直接粘贴图片到文档中并自动处理图片落盘与路径补全相关实现见 packages/desktop/src/main/utils/imagePathAutoComplement.ts。主题体系与切换方式MarkText 内置 33 款主题按浅色Light与深色Dark分组。菜单中的主题项由 packages/desktop/src/main/menu/templates/theme.ts 动态构建其中保留了部分历史主题 ID 映射——例如菜单中的Cadmium Light对应主题 IDlight、Cadmium Dark对应dark、Graphite Light对应graphite、Ulysses Light对应ulysses这些 ID 会持久化到preferences.json的theme字段中。切换主题有几种途径菜单切换打开Theme菜单在浅色主题 / 深色主题子菜单中选择偏好设置在Preferences → Theme选项卡中预览并选择跟随系统启用 Follow System Theme跟随系统主题后MarkText 会根据操作系统的浅色/深色设置自动切换主题。从源码结构看theme.ts中LIGHT_THEMES与DARK_THEMES数组正是菜单选项的数据来源且当跟随系统主题开启时主题单选菜单会被禁用isThemeSelectionEnabled !followSystemTheme避免手动选择与系统设置冲突。各主题的完整名称、说明与效果图可在 主题文档 中查阅。关于主题的持久化配置结构可参考 packages/desktop/src/main/preferences/schema.json。跨平台下载与安装MarkText 支持Linux、macOS 与 Windows三大平台每个发布版本都会产出对应的安装包官方文档中列出了各平台的推荐安装方式。安装包命名与平台支持根据打包配置 packages/desktop/electron-builder.yml各平台产物的命名规则如下平台安装包产物说明Windowsmarktext-win-${arch}-${version}-setup.exe、marktext-win-${arch}-${version}.zipNSIS 安装器 便携 zip支持 x64 / arm64macOSmarktext-mac-${arch}-${version}.dmg、.zipDMG 镜像支持 arm64Apple Silicon/ x64IntelLinuxmarktext-linux-${version}.AppImage、.deb、.rpm、.snap、.tar.gz五种发行格式其中 Windows 安装器采用 NSIS 方案支持选择按用户安装或按机器安装perMachine: false并创建桌面与开始菜单快捷方式。安装后MarkText 会自动注册为.md、.markdown、.mmd、.mdown、.mdtxt、.mdtext等扩展名的默认打开程序fileAssociations配置。详细的安装矩阵与选择建议见 packages/website/content/docs/end-user/INSTALLATION.md。macOS 安装在 macOS 上可以直接从发布页下载最新的marktext-mac-arch-version.dmgApple Silicon 选择 arm64 包Intel Mac 选择 x64 包打开 DMG 后将 MarkText 拖入 Applications 文件夹即可也可以使用 Homebrew Cask 一键安装brew install --cask mark-text注意当前发布版本未做公证notarize: false首次启动时系统 Gatekeeper 可能弹出提示此时在应用上右键选择打开确认一次即可。Windows 安装Windows 用户下载marktext-setup-version.exe后跟随向导安装并选择按用户安装或按机器安装即可。此外还可以通过包管理器安装# Chocolatey choco install marktext # Winget winget install marktextLinux 安装Linux 用户请遵循官方 Linux 安装说明。最常见的 AppImage 使用方式如下chmod x marktext-linux-version.AppImage ./marktext-linux-version.AppImageAppImage 无需 root 权限即可运行若希望集成到桌面环境可以手动创建 desktop entry将marktext.desktop放到~/.local/share/applications/并执行update-desktop-database ~/.local/share/applications/使用 AppImageLauncher由工具自动处理桌面集成。此外还支持.debsudo apt install ./marktext-linux-version.deb、.rpmsudo rpm -i ...、.snapsudo snap install ... --dangerous --classic以及便携tar.gz包Arch Linux 用户可通过 AUR 的marktext-bin安装yay -S marktext-bin。卸载时删除对应安装文件并清理用户配置目录~/.config/marktext即可。校验下载文件每个发布版本都会附带latest-platform.yml校验文件其中包含各产物的SHA-512 哈希。下载后可以自行校验完整性# 示例macOS / Linux shasum -a 512 marktext-linux-version.AppImage将输出值与发布页latest-linux.yml中的记录比对即可。更新与卸载MarkText 会在启动时检查更新可在Preferences → General → Updates中关闭。发现新版本后应用会在后台下载并在下次重启时安装。便携版zip / AppImage不会自动更新需要手动下载最新产物替换。从源码构建与开发如果你希望自行编译 MarkText例如跟踪develop分支、运行官方未提供二进制的架构或参与贡献可以参考开发者文档 构建指南。环境要求Node.js20.19.0pnpm10根 package.json 中engines字段同样声明了该要求并固定使用pnpm10.33.4Python3.12用于 node-gyp 编译原生模块C 编译器与开发工具。Linux 下还需安装系统级依赖libx11-dev libxkbfile-dev libsecret-1-dev libfontconfig-devDebian 系Red Hat 系对应libX11-devel libxkbfile-devel libsecret-devel fontconfig-develWindows 下需要 Visual Studio 2022Build Tools。构建步骤git clone 仓库地址 cd marktext pnpm install pnpm run build构建产物输出到dist/目录electron-builder 输出。如果只想以开发模式运行并实时热重载pnpm run dev常用脚本见根 package.json 与 packages/desktop/package.json脚本说明pnpm run dev开发模式源码修改后自动重载窗口pnpm run build构建当前平台的应用与安装包pnpm run build:win/build:mac/build:linux构建指定平台产物pnpm run lintESLint 代码风格检查pnpm run test/test:unit/test:e2e单元测试与 Playwright 端到端测试packages/desktop/test/e2e下提供了大量端到端用例如export-pdf.spec.ts、themes.spec.ts、view-modes.spec.ts等可作为功能行为的验证样本。参与贡献与开源生态MarkText 仍处于积极开发阶段。官方文档建议提交 Pull Request 前阅读贡献指南并使用默认的 issue 模板提问想新增功能时参考项目路线图与已开放的 issue欢迎通过赞助支持项目持续发展文档中列出了 SerpAPI、UKey 等赞助商。项目发布历史可查阅 CHANGELOG。更多用户文档快捷键、偏好设置、图片上传、拼写检查等与开发者文档架构、IPC、调试、性能等分别位于 packages/website/content/docs/end-user 与 packages/website/content/docs/dev。延伸阅读官方主 READMEREADME.md多语言版本本文对应的西班牙语原文见 docs/i18n/README-es.md另有简体中文、繁体中文、日语、德语、法语 等版本安装细节INSTALLATION.md、LINUX.md主题体系THEMES.md、theme.ts打包配置electron-builder.yml渲染引擎packages/muya许可证LICENSEMIT【免费下载链接】marktextA simple and elegant markdown editor, available for Linux, macOS and Windows.项目地址: https://gitcode.com/gh_mirrors/ma/marktext创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 MarkText 开源 Markdown 编辑器全面指南：核心特性、跨平台安装与源码构建
MarkText 开源 Markdown 编辑器全面指南核心特性、跨平台安装与源码构建【免费下载链接】marktextA simple and elegant markdown editor, available for Linux, macOS and Windows.项目地址: https://gitcode.com/gh_mirrors/ma/marktext本文基于仓库内西班牙语官方文档 docs/i18n/README-es.md 整理编写并结合仓库源码、打包配置与开发者文档进行补充。MarkText 是一款面向 Linux、macOS 与 Windows 的开源 Markdown 编辑器主打所见即所得WYSIWYG的实时预览、简洁优雅的界面与流畅的写作体验。读完本文你将掌握 MarkText 的全部核心特性、三大平台的安装与卸载方法、主题切换机制以及从源码自行构建应用的完整流程。MarkText 是什么新一代 Markdown 编辑器MarkText 是一个开源的下一代 Markdown 编辑器其定位是简单而优雅并且专注于速度与易用性focused on speed and usability。它由 Jocs当前仓库版本为0.20.0-dev见 package.json。项目以 pnpm monorepo 形式组织核心构成包括packages/desktop基于 Electron 的桌面应用主程序负责窗口管理、菜单、偏好设置与文件系统packages/muyaMarkdown 渲染引擎muyajs/core负责将 Markdown 解析为块级 DOM 并实现 WYSIWYG 实时预览packages/website官方文档与官网站点源码。在渲染能力上MarkText 内部集成了katex数学公式、mermaid、flowchart.js、plantuml图表、prismjs代码高亮、turndown与joplin-turndown-plugin-gfmMarkdown 导出等关键依赖见 packages/desktop/package.json从依赖层面即可看出其完整的 Markdown 生态支持。核心功能特性根据官方文档MarkText 的核心特性可以归纳为以下几个方面实时预览WYSIWYG与无干扰写作MarkText 提供实时预览What You See Is What You Get能力界面干净、简洁让作者获得无干扰的写作体验。与传统左侧源码、右侧预览的双栏编辑器不同MarkText 将渲染结果直接呈现在编辑区标题、列表、表格等以最终形态实时呈现。标准语法兼容与扩展语法兼容 CommonMark Spec 规范兼容 GitHub Flavored Markdown SpecGFM规范选择性支持 Pandoc markdown 语法支持多种 Markdown 扩展语法包括数学公式KaTeX、front matter前置元数据与emoji 表情。仓库中packages/muya引擎的src/state目录下提供了markdownToState.ts、stateToMarkdown.ts、htmlToMarkdown.ts、markdownToHtml.ts等核心转换实现见 packages/muya/src/state配套的test/spec/commonmark.spec.ts与gfm.spec.ts则承担了规范符合性的回归验证。段落与行内样式快捷键MarkText 支持段落级与行内样式级快捷键帮助提升写作效率例如快速设置标题级别、加粗、斜体、代码块、引用、列表等。行内格式的完整快捷键定义可参考 packages/desktop/src/main/keyboard/keybindingsLinux.ts 等平台绑定文件。导出 HTML 与 PDF文档可直接导出为HTML与PDF文件满足分享与打印需求。仓库的端到端测试中包含 export-pdf.spec.ts用于验证 PDF 导出流程。多主题与多编辑模式多种主题内置包括Cadmium Light默认浅色、Material DarkMaterial 风格深色在内的 33 款主题涵盖浅色与深色两大类多种编辑模式源码模式Source Code mode、打字机模式Typewriter mode与专注模式Focus mode分别满足查看 Markdown 源码、居中光标打字、弱化非当前段落等不同写作场景。主题的完整清单与切换方式参见 packages/website/content/docs/end-user/THEMES.md。剪贴板直接粘贴图片支持从系统剪贴板直接粘贴图片到文档中并自动处理图片落盘与路径补全相关实现见 packages/desktop/src/main/utils/imagePathAutoComplement.ts。主题体系与切换方式MarkText 内置 33 款主题按浅色Light与深色Dark分组。菜单中的主题项由 packages/desktop/src/main/menu/templates/theme.ts 动态构建其中保留了部分历史主题 ID 映射——例如菜单中的Cadmium Light对应主题 IDlight、Cadmium Dark对应dark、Graphite Light对应graphite、Ulysses Light对应ulysses这些 ID 会持久化到preferences.json的theme字段中。切换主题有几种途径菜单切换打开Theme菜单在浅色主题 / 深色主题子菜单中选择偏好设置在Preferences → Theme选项卡中预览并选择跟随系统启用 Follow System Theme跟随系统主题后MarkText 会根据操作系统的浅色/深色设置自动切换主题。从源码结构看theme.ts中LIGHT_THEMES与DARK_THEMES数组正是菜单选项的数据来源且当跟随系统主题开启时主题单选菜单会被禁用isThemeSelectionEnabled !followSystemTheme避免手动选择与系统设置冲突。各主题的完整名称、说明与效果图可在 主题文档 中查阅。关于主题的持久化配置结构可参考 packages/desktop/src/main/preferences/schema.json。跨平台下载与安装MarkText 支持Linux、macOS 与 Windows三大平台每个发布版本都会产出对应的安装包官方文档中列出了各平台的推荐安装方式。安装包命名与平台支持根据打包配置 packages/desktop/electron-builder.yml各平台产物的命名规则如下平台安装包产物说明Windowsmarktext-win-${arch}-${version}-setup.exe、marktext-win-${arch}-${version}.zipNSIS 安装器 便携 zip支持 x64 / arm64macOSmarktext-mac-${arch}-${version}.dmg、.zipDMG 镜像支持 arm64Apple Silicon/ x64IntelLinuxmarktext-linux-${version}.AppImage、.deb、.rpm、.snap、.tar.gz五种发行格式其中 Windows 安装器采用 NSIS 方案支持选择按用户安装或按机器安装perMachine: false并创建桌面与开始菜单快捷方式。安装后MarkText 会自动注册为.md、.markdown、.mmd、.mdown、.mdtxt、.mdtext等扩展名的默认打开程序fileAssociations配置。详细的安装矩阵与选择建议见 packages/website/content/docs/end-user/INSTALLATION.md。macOS 安装在 macOS 上可以直接从发布页下载最新的marktext-mac-arch-version.dmgApple Silicon 选择 arm64 包Intel Mac 选择 x64 包打开 DMG 后将 MarkText 拖入 Applications 文件夹即可也可以使用 Homebrew Cask 一键安装brew install --cask mark-text注意当前发布版本未做公证notarize: false首次启动时系统 Gatekeeper 可能弹出提示此时在应用上右键选择打开确认一次即可。Windows 安装Windows 用户下载marktext-setup-version.exe后跟随向导安装并选择按用户安装或按机器安装即可。此外还可以通过包管理器安装# Chocolatey choco install marktext # Winget winget install marktextLinux 安装Linux 用户请遵循官方 Linux 安装说明。最常见的 AppImage 使用方式如下chmod x marktext-linux-version.AppImage ./marktext-linux-version.AppImageAppImage 无需 root 权限即可运行若希望集成到桌面环境可以手动创建 desktop entry将marktext.desktop放到~/.local/share/applications/并执行update-desktop-database ~/.local/share/applications/使用 AppImageLauncher由工具自动处理桌面集成。此外还支持.debsudo apt install ./marktext-linux-version.deb、.rpmsudo rpm -i ...、.snapsudo snap install ... --dangerous --classic以及便携tar.gz包Arch Linux 用户可通过 AUR 的marktext-bin安装yay -S marktext-bin。卸载时删除对应安装文件并清理用户配置目录~/.config/marktext即可。校验下载文件每个发布版本都会附带latest-platform.yml校验文件其中包含各产物的SHA-512 哈希。下载后可以自行校验完整性# 示例macOS / Linux shasum -a 512 marktext-linux-version.AppImage将输出值与发布页latest-linux.yml中的记录比对即可。更新与卸载MarkText 会在启动时检查更新可在Preferences → General → Updates中关闭。发现新版本后应用会在后台下载并在下次重启时安装。便携版zip / AppImage不会自动更新需要手动下载最新产物替换。从源码构建与开发如果你希望自行编译 MarkText例如跟踪develop分支、运行官方未提供二进制的架构或参与贡献可以参考开发者文档 构建指南。环境要求Node.js20.19.0pnpm10根 package.json 中engines字段同样声明了该要求并固定使用pnpm10.33.4Python3.12用于 node-gyp 编译原生模块C 编译器与开发工具。Linux 下还需安装系统级依赖libx11-dev libxkbfile-dev libsecret-1-dev libfontconfig-devDebian 系Red Hat 系对应libX11-devel libxkbfile-devel libsecret-devel fontconfig-develWindows 下需要 Visual Studio 2022Build Tools。构建步骤git clone 仓库地址 cd marktext pnpm install pnpm run build构建产物输出到dist/目录electron-builder 输出。如果只想以开发模式运行并实时热重载pnpm run dev常用脚本见根 package.json 与 packages/desktop/package.json脚本说明pnpm run dev开发模式源码修改后自动重载窗口pnpm run build构建当前平台的应用与安装包pnpm run build:win/build:mac/build:linux构建指定平台产物pnpm run lintESLint 代码风格检查pnpm run test/test:unit/test:e2e单元测试与 Playwright 端到端测试packages/desktop/test/e2e下提供了大量端到端用例如export-pdf.spec.ts、themes.spec.ts、view-modes.spec.ts等可作为功能行为的验证样本。参与贡献与开源生态MarkText 仍处于积极开发阶段。官方文档建议提交 Pull Request 前阅读贡献指南并使用默认的 issue 模板提问想新增功能时参考项目路线图与已开放的 issue欢迎通过赞助支持项目持续发展文档中列出了 SerpAPI、UKey 等赞助商。项目发布历史可查阅 CHANGELOG。更多用户文档快捷键、偏好设置、图片上传、拼写检查等与开发者文档架构、IPC、调试、性能等分别位于 packages/website/content/docs/end-user 与 packages/website/content/docs/dev。延伸阅读官方主 READMEREADME.md多语言版本本文对应的西班牙语原文见 docs/i18n/README-es.md另有简体中文、繁体中文、日语、德语、法语 等版本安装细节INSTALLATION.md、LINUX.md主题体系THEMES.md、theme.ts打包配置electron-builder.yml渲染引擎packages/muya许可证LICENSEMIT【免费下载链接】marktextA simple and elegant markdown editor, available for Linux, macOS and Windows.项目地址: https://gitcode.com/gh_mirrors/ma/marktext创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考