MarkText 跨平台 Markdown 编辑器完全指南:从安装、WYSIWYG 写作到源码构建(基于官方日文文档与仓库源码)

发布时间:2026/11/13 11:33:00

MarkText 跨平台 Markdown 编辑器完全指南:从安装、WYSIWYG 写作到源码构建(基于官方日文文档与仓库源码) MarkText 跨平台 Markdown 编辑器完全指南从安装、WYSIWYG 写作到源码构建基于官方日文文档与仓库源码【免费下载链接】marktextA simple and elegant markdown editor, available for Linux, macOS and Windows.项目地址: https://gitcode.com/gh_mirrors/ma/marktextMarkText 是一款面向 Linux、macOS、Windows 的开源 Markdown 编辑器以速度与易用性为核心提供所见即所得WYSIWYG的实时预览与干净专注的写作界面。本文以仓库中的日文官方文档 docs/i18n/README-jp.md 为主体骨架结合仓库内安装、主题、构建等真实文档与源码完整讲解其功能特性、三平台安装方式、包管理器使用、常见问题排查以及从源码自行构建的开发流程读完即可独立完成 MarkText 的安装、配置与二次开发环境搭建。MarkText 是什么面向写作场景的次世代 Markdown 编辑器根据 docs/i18n/README-jp.md 的介绍MarkText 被定位为次世代Next generation的 Markdown 编辑器主打速度speed与易用性usability是一个简单、优雅的开源 Markdown 编辑器官方支持Linux、macOS、Windows三大桌面平台。从仓库结构看MarkText 是一个 pnpm monorepo 工程根目录 package.json 声明packageManager: pnpm10.33.4核心包含三个工作区包packages/desktop基于 Electron Vue 3 的桌面应用外壳主进程、预加载脚本、渲染进程packages/muyamuyajs/core使用 TypeScript 重写的编辑器内核Markdown 解析、块结构、WYSIWYG 渲染基于ot-json1 ot-text-unicode snabbdom marked构建packages/muyajs旧版 JS 编辑器引擎marktext/muyajs正被新内核逐步替代。编辑器引擎与桌面壳分离的架构详见 CLAUDE.md 的目录结构说明意味着 MarkText 的 Markdown 解析与渲染能力是独立、可测试的这也是它能同时保证解析规范性与渲染性能的底层原因。核心功能一览从 Markdown 规范到写作体验日文文档 docs/i18n/README-jp.md 明确列出了 MarkText 的核心功能本文逐条展开并补充仓库内的实现佐证1. 实时预览WYSIWYG与专注写作体验MarkText 提供实时预览What You See Is What You Get能力配合简洁干净的界面让写作者专注于内容本身。编辑器内所见即所得的效果由渲染进程中的编辑器内核负责渲染进程代码位于 packages/desktop/src/renderer/src其编辑器引擎消费muyajs/core见 packages/desktop/package.json 中的依赖声明muyajs/core: workspace:*。2. Markdown 规范支持完整支持CommonMark Spec与GitHub Flavored MarkdownGFMSpec部分支持 Pandoc Markdown语法仓库中 packages/muya/test/spec 下的commonmark.spec.ts、gfm.spec.ts、roundTrip.spec.ts即为对应规范的一致性测试conformance tests验证解析器对规范语法的符合度。3. Markdown 扩展数学公式KaTeX依赖katex见 packages/desktop/package.json支持行内与块级数学公式渲染Front MatterYAML 前置元数据Emoji 表情此外还支持Mermaid 图表、PlantUML、flowchart.js、Vega-Lite等图表扩展依赖列表中可见mermaid、flowchart.js、vega-embed等CLAUDE.md 的项目概述也确认了这一点。4. 写作效率快捷键支持段落级别与行内样式inline style的快捷键例如标题切换、加粗、斜体、引用、列表等提高写作效率。快捷键与命令绑定实现在 packages/desktop/src/main/keyboard 与 packages/desktop/src/common/keybinding并针对 macOS / Linux / Windows 分别提供键位配置。5. 导出能力可导出HTML与PDF文件。导出实现在主进程的文件系统模块中仓库测试 packages/desktop/test/unit/specs/exportHtml.spec.ts 与pdf.spec.ts等单元测试覆盖了导出逻辑。6. 主题系统内置多种主题文档特别提到Cadmium Light、Material Dark等。根据 packages/website/content/docs/end-user/THEMES.mdMarkText 内置33 个主题分为 Light浅色与 Dark深色两大类浅色主题包括 Ayu Light、Cadmium Light默认、Catppuccin Latte、Solarized Light 等深色主题包括 Cadmium Dark、Material Dark、One Dark、Dracula、Nord、Tokyo Night、Rosé Pine 等。主题可通过菜单 → Theme、偏好设置 → Theme 标签页切换也可以启用Follow System Theme跟随系统亮暗模式自动切换。主题的 label↔id 映射定义在 packages/desktop/src/main/menu/templates/theme.ts。7. 多种编辑模式支持源代码模式Source Code mode、打字机模式Typewriter mode与专注模式Focus mode源代码模式使用 CodeMirror 5 提供纯 Markdown 源码编辑依赖见 packages/desktop/package.json 中的codemirror打字机模式与专注模式则服务于沉浸式写作。8. 剪贴板直接粘贴图片支持从系统剪贴板直接粘贴图片到文档粘贴后会自动写入图片文件并插入引用相关测试见 packages/desktop/test/unit/specs/upload-image.spec.ts 与 muya 侧的pasteImage实现packages/muya/src/clipboard/pasteImage.ts。下载与安装三大平台与包管理器全解MarkText 随每个 release 发布预编译二进制文件支持平台覆盖Linux x64、macOS x64/arm64、Windows x64/arm64。以下安装说明综合 docs/i18n/README-jp.md 与仓库内更详细的 packages/website/content/docs/end-user/INSTALLATION.md。macOS 安装方式一从 release 页面下载最新的marktext-mac-(arm64|x64)-版本.dmg。注意官方不发布 Universal 通用构建请按芯片架构选择arm64Apple Silicon M 系列或x64Intel对应的安装包。安装后如遇 Gatekeeper 提示可右键应用选择打开以接受一次当前构建未做 notarization 公证。方式二使用 Homebrew Cask 安装需先安装 Homebrewbrew install --cask mark-textWindows 安装下载并运行安装向导marktext-setup-版本.exe可在用户级per-user与系统级machine wide两种安装方式中选择也支持便携版 zip解压即用数据可跟随应用存放详见 packages/website/content/docs/end-user/PORTABLE.md。安装完成后 MarkText 会自动注册为.md、.markdown、.mmd、.mdown、.mdtxt、.mdtext文件的默认打开程序。除安装向导外还可以使用包管理器需预先安装对应工具# Chocolatey choco install marktext # Windows Package Manager (Winget) winget install marktextLinux 安装Linux 是 MarkText 发布格式最丰富的平台共提供五种格式完整步骤见 packages/website/content/docs/end-user/LINUX.md格式适用场景marktext-linux-版本.AppImage推荐。无需 rootchmod x后直接运行兼容大多数发行版marktext-linux-版本.debDebian / Ubuntu / Linux Mint / Pop!_OS 等sudo apt install ./marktext-linux-版本.debmarktext-linux-版本.rpmFedora / RHEL / openSUSE 等sudo rpm -i marktext-linux-版本.rpmmarktext-linux-版本.snap支持 snap 的发行版sudo snap install marktext-linux-版本.snap --dangerous --classicmarktext-linux-版本.tar.gz便携 tar 包解压后运行其中的marktext可执行文件AppImage 使用要点packages/website/content/docs/end-user/LINUX.md# 1. 赋予可执行权限并运行 chmod x marktext-版本-x86_64.AppImage ./marktext-版本-x86_64.AppImage # 2. 集成到桌面环境可选创建 desktop entry 或使用 AppImageLauncher # 手动创建 desktop entry curl -L https://raw.githubusercontent.com/marktext/marktext/develop/resources/linux/marktext.desktop -o $HOME/.local/share/applications/marktext.desktop # 编辑该文件中的 Exec 为真实命令后 update-desktop-database $HOME/.local/share/applications/ # 3. 卸载删除 AppImage 文件、desktop 文件以及用户配置目录 ~/.config/marktextArch Linux 用户可通过 AUR 安装marktext-binyay -S marktext-bin该包会自动处理glibc、gtk3、nss、alsa-lib、libxss、cups、libxkbcommon、libxkbfile、mesa、hicolor-icon-theme等依赖。注意 AUR 包并非本仓库维护者维护版本可能滞后安装前建议核对 PKGBUILD 中的版本号。校验下载与更新、卸载校验每个 release 附带latest-平台.yml文件包含 SHA-512 哈希可用shasum -a 512 marktext-linux-版本.AppImage对比校验见 INSTALLATION.md。更新MarkText 启动时会检查更新可在偏好设置 → General → Updates关闭发现新版本后在后台下载、下次重启时安装便携版 zip 与 AppImage 不参与自动更新需要手动重新下载最新构件详见 INSTALLATION.md。卸载Windows 通过设置 → 应用或运行自带的Uninstall MarkText.exemacOS 直接删除 MarkText.app可同时清理~/Library/Application Support/marktextLinux 下.deb用sudo apt remove marktext、.rpm用sudo rpm -e marktext、snap 用sudo snap remove marktext、AppImage/tar.gz 直接删除文件即可。如需彻底清除用户数据删除对应的应用数据目录即可。命令行选项MarkText 还提供命令行接口详见 packages/website/content/docs/end-user/CLI.mdUsage: marktext [commands] [path ...] --debug 启用调试模式 --safe 禁用插件与其他用户配置 -n, --new-window 在第二实例时打开新窗口 --user-data-dir 修改用户数据目录 --disable-gpu 禁用 GPU 硬件加速 --disable-spellcheck 本次会话禁用拼写检查 -v, --verbose 输出详细日志 --version 打印版本信息 -h, --help 打印帮助信息在 macOS 上可创建便捷别名alias marktext/Applications/Mark\ Text.app/Contents/MacOS/Mark\ Text。从源码构建与开发模式如果希望自行构建 MarkText例如跟踪 develop 分支、为官方未发布的架构构建或参与开发请参考 packages/website/content/docs/dev/BUILD.md。要点如下环境前置条件Node.js20.19.0pnpm10根 package.json 声明enginesPython3.12供 node-gyp 编译原生模块C 编译器与开发工具构建在 Linux、macOS、Windows 上均受支持。Linux 额外依赖Debian 系sudo apt-get install libx11-dev libxkbfile-dev libsecret-1-dev libfontconfig-dev rpmRed Hat 系对应dnf install libX11-devel libxkbfile-devel libsecret-devel fontconfig-devel。构建步骤git clone https://github.com/marktext/marktext.git cd marktext pnpm install # 自动执行 postinstall 脚本打补丁、下载 Electron、重建原生模块、压缩 locale pnpm run build # 构建当前平台的二进制与安装包产物位于仓库根目录dist/文件夹electron-builder 输出中间产物在packages/desktop/out/。BUILD.md 还提供基于容器podman/docker的构建方式可在干净的 Debian bookworm 环境中一键完成依赖安装与构建。常用开发脚本BUILD.md 的脚本表脚本说明pnpm run build构建当前平台的二进制与安装包pnpm run dev以开发模式构建并运行 MarkText源码改动自动热重载渲染进程主进程改动需重启pnpm run lintESLint 代码风格检查pnpm run test运行单元测试Vitest开发模式中可用CtrlR手动重载渲染进程以提升开发效率详见 BUILD.md 的 TIP。平台专属构建命令包括pnpm run build:winNSIS 安装器 zip、pnpm run build:macDMG zipx64/arm64、pnpm run build:linuxAppImage、snap、deb、rpm、tar.gz这些命令在打包前会自动执行minify-locales与electron-rebuild。参与贡献从 Issue 到 Pull RequestMarkText 仍处于活跃开发中当前仓库版本为0.20.0-dev。如果你想参与提 Issue 时请使用默认的 issue 模板关于使用或功能问题均可直接创建 issue提交 Pull Request 前务必阅读贡献指南详见 packages/website/content/docs/dev/README.md 对应文档以及仓库内贡献规范PR 请提交到develop分支并在描述中关联相关 issue想了解项目规划可参考项目路线图roadmap与开放的 issue 列表深度开发者可进一步阅读 packages/website/content/docs/dev/ARCHITECTURE.md进程与模块分层、packages/website/content/docs/dev/IPC.mdmt::前缀 IPC 通道约定与 packages/website/content/docs/dev/DEBUGGING.md主进程/渲染进程调试等开发文档版本更新内容可查阅 packages/website/content/docs/CHANGELOG.md。许可证MarkText 以MIT License开源发布见根目录 LICENSE允许自由使用、修改与再分发。综上MarkText 通过 WYSIWYG 实时预览、CommonMark/GFM/Pandoc 语法支持、KaTeX 数学公式与图表扩展、丰富的主题与编辑模式为 Markdown 写作提供了完整的桌面体验同时凭借三平台二进制、主流包管理器Homebrew、Chocolatey、Winget、AUR支持以及清晰的可复现构建流程无论是普通写作者还是希望深入源码的开发者都能快速上手。本文所有安装命令与构建步骤均以当前仓库中的官方文档为准实际使用中请以对应平台的 release 页面与 packages/website/content/docs 下的用户/开发者文档为最新依据。【免费下载链接】marktextA simple and elegant markdown editor, available for Linux, macOS and Windows.项目地址: https://gitcode.com/gh_mirrors/ma/marktext创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/11/11 15:14:44

9款高效AI工具推荐:学生与职场新人必备

1. 项目概述作为一名在AI工具应用领域深耕多年的实践者,我经常收到专科院校学生和职场新人的咨询:面对市面上五花八门的AI工具,如何选择真正适合自己的?哪些工具能切实提升学习效率而不是制造更多麻烦?今天我就结合自己…

2026/11/12 1:52:07

像蜂鸟一样轻快:Colibri轻量级CMS部署与扩展实践

第一次看到“Colibri”这个名字,我脑子里蹦出来的是那种能在半空悬停的蜂鸟。后来翻完项目说明才发现,这个开源项目取名是真没偷懒——它想做的就是一个像蜂鸟一样轻巧、灵活、反应快的内容管理系统。跟那些动辄几百兆、后台配置项密密麻麻的“重型CMS”…

2026/11/13 11:29:07

氯气特种作业操作证值不值得考?别交了培训费还考不过

氯气特种作业操作证值不值得考?别交了培训费还考不过 怕考不过白交培训费?氯气特种作业操作证确实让人头疼,尤其是对南阳卧龙区初次报考的小伙伴来说,培训费动辄几千块,如果没准备好,真的可能竹篮打水一场空。那这个证值不值得考?咱们先说重点,再讲干…

2026/11/13 11:29:07

肥东电工证怎么考在哪考最靠谱别被中介坑

肥东电工证怎么考在哪考最靠谱别被中介坑 不知道去哪报名怕被中介坑,这是很多想要考电工证的小伙伴的真实感受。尤其在肥东,找一个靠谱的报名点比找对象还难。现在市面上各种培训机构五花八门,价格参差不齐,有些甚至打着“包过”“速成”的幌子,实际是骗…

2026/11/13 11:29:07

证书过期了不知道怎么复审延期?惠阳水电工证培训机构值不值得考

证书过期了不知道怎么复审延期?惠阳水电工证培训机构值不值得考 你是不是也遇到过这样的情况:手里的特种作业证快到期了,不知道去哪儿复审,更不知道该不该继续考?其实这背后的问题,远不止是一张证书的事情,还牵涉到你未来的工作安全、法律责任甚至职业…

2026/11/13 11:29:07

广元低压电工证报名机构真实经历:外省证书如何转过来

广元低压电工证报名机构真实经历:外省证书如何转过来 之前考的证在外省能不能转过来?这事儿我见过太多人问了,特别是像你这样在洛阳涧西区从事公路工程的同行,手里有张外省低压电工证,想在广元本地用,但不知道能不能转,流程又该怎么做。今天我就用一个…

2026/11/13 11:24:06

广州维修电工证怎么考?学历不高怕报不上名?考前押题帮你稳过

广州维修电工证怎么考?学历不高怕报不上名?考前押题帮你稳过 你是不是也担心自己学历不高,怕报不了广州维修电工证?别急,今天就给你支招,从报名到考试,再到以后的薪资前景,一网打尽,让你少走弯路。 广州维修电工证报名条件与材料清单…

2026/11/12 20:35:13

电工证丢失还能补吗?千万别踩坑,丢了证等于失业

电工证丢失还能补吗?千万别踩坑,丢了证等于失业 你正在找工作,但手里的电工证突然丢了,这下怎么办?别急,先别慌, 电工证丢失还能补吗 ?答案是肯定的,但 千万别踩坑 ,补办流程如果不了解,可能会耽误你上岗、甚至影响到你的收入。…

2026/11/13 0:01:06

办上海高压电工证良心建议:别被中介坑了,自己看这篇就够了

办上海高压电工证良心建议:别被中介坑了,自己看这篇就够了 你是不是也像我一样,第一次听说“高压电工证”这个名词,就感觉一头雾水?其实很多人都跟我一样,不知道去哪报名、怕被中介坑,结果花了冤枉钱还考不上。今天我就从一个在商丘培训过的学员角度,…

2026/11/13 0:01:06

黎里考电工证在哪里值不值得考

黎里考电工证在哪里值不值得考 之前考的证在外省能不能转过来?这是很多在外地工作、准备回老家发展的朋友最关心的问题。特别是在黎里地区,很多从事电力相关工作的朋友,都面临这样一个难题: 外省的电工证能否在本地使用?值不值得考?…

2026/11/13 0:01:06

毕节哪里考电工证 怎么报名学历不高也能上手

毕节哪里考电工证 怎么报名学历不高也能上手 你是不是也和我一样,学历不高,想着考个电工证,但又担心自己条件不够,怕报不上名?其实不然,只要符合条件,学历不高也能考电工证。今天就来聊聊【毕节哪里考电工证】这个问题,还有怎么报名,让你一步到位不…

2026/11/12 22:10:13

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代,基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而,与配合度高的人类不同,宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态,更无法控制光照环境。实际应用中,我们常…

2026/11/12 9:51:42

SSM电子书店源码全解析:结构、原理、部署与排错实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑