企业官网建设流程全解析

Typora开始收费之后，我花了不少个晚上试了一圈免费的Markdown编辑器，最后真正留在手里的，反而不是那些界面酷炫的新产品，而是一个老牌开源项目——MarkText。这玩意儿在GitHub上攒了几万星，界面长得和Typora几乎是一个路数，实时预览、数学公式、表格、代码高亮这些刚需功能全部都有，而且跨Windows、macOS、Linux三平台，下载即用，不登录、不付费、不把你的文档上传到任何服务器。

这篇文章不是官方文档的复读，我把它当主力笔记工具用了两年多，从安装配置、日常写作、图床方案到各种边角问题都踩过一遍，下面这些是我个人操作下来最能直接用的经验。我会把每一步“为什么这么做”也讲清楚，免得你看完照抄，结果遇到环境差异却不知道怎么调整。

1. MarkText到底能做什么，凭什么值得换掉Typora

1.1 实时渲染与源码模式的切换逻辑

MarkText默认的编辑体验是“所见即所得”：你在编辑区输入的Markdown符号，在输入完成的一瞬间就被渲染成对应的格式，标题自动变粗变大、列表出现圆点、代码块变成深色底。这种模式对刚接触Markdown的人尤其友好，因为排版语法你只需要记住极少数符号，剩下的交给渲染器处理就行。

关键点在于，MarkText把“编辑区”和“预览区”直接合并成一个区域，这和传统的左右分栏编辑器体验完全不同。传统编辑器左边写源码右边看效果，眼睛需要在两个区域之间来回跳，写长文时很容易累。MarkText的实时渲染省掉了这个切换动作，你眼睛看到的样子，就是最终导出文档的样子。

如果你依赖原始语法来检查格式，可以一键切到源码模式。MarkText的源码模式不是那种全裸的纯文本视图，它会把标题、列表、引用这些块级结构折叠起来，以大纲结构的形式展示。我实际用下来的感受是：改文档结构时非常舒服，先把正文全部折叠，光看各级标题，比滚屏翻找高效得多。很多新手不知道这个小细节，建议拿到手先试试。

1.2 和Typora的对比与选择建议

拿MarkText和Typora对比是绕不开的话题，毕竟大多数人找MarkText就是为了做平替。如果你问我“凭什么换掉Typora”，我用下来感受最明显的是三条：

• 免费开源，离线可用，没有订阅制，付费功能更是谈不上。
• 原生支持GFM，即GitHub风格Markdown，表格、任务列表、删除线、emoji短代码都能正常渲染。
• 对图片的处理很顺手，拖拽或剪贴板粘贴图片可以直接保存到本地，也支持图床上传。

但你也要知道MarkText的短板：项目维护节奏偏慢，版本号停留在0.17.x，一些细小的bug修得不算快；对脚注这类高级扩展语法的支持比较一般，重度学术写作可能不够用。

我给你的选择标准很简单：笔记自己用、格式不复杂、想要免费跨平台，直接MarkText没毛病；如果你对复杂表格排版有很强的需求，或者重度依赖文档脚注与交叉引用，那付费商业编辑器可能更稳。工具这东西没有“最好”，只有“顺手”。

2. 从安装到配置，先把环境搞舒服

2.1 各平台安装方式和版本选择

MarkText的安装没有太多门槛，但有个小坑：它每个版本会在GitHub Releases里同时提供好几个安装包，新手经常下错。我的建议是看清楚后缀再动手：

• Windows：下载exe安装包，或者使用免安装的portable版本。
• macOS：用Homebrew执行 brew install --cask marktext，也可以直接下载dmg拖进应用程序目录。
• Linux：优先推荐AppImage格式，下载后记得赋予执行权限，或者用发行版的包管理器装snap版、flatpak版。

安装完成后先别看功能，先去“偏好设置”里干一件事：把自动检查更新关掉。原因很简单，MarkText的迭代节奏慢，老版本不一定比新版本差，每次弹更新提示还挺烦。Electron应用在Windows下偶尔会被杀毒软件误报，这是共性现象，如果你遇到，加白名单或者改用portable版本都能解决。

2.2 接近零成本的五个必调配置项

装好之后别急着写，有五个配置项我觉得值得先动，它们能直接改善日常体验。字体和编辑器主题我放在后面细说，这里先给一个清单：

• 在“通用”里关闭自动更新，避免后台下载和烦人弹窗。
• 在“外观”里把编辑器字体改成你习惯的等宽字体，比如JetBrains Mono、Consolas，代码和表格看起来会舒服很多。
• 在“编辑器”里开启显示行号与自动换行。行号对定位代码块和长文回查很有用，自动换行则避免横向滚动条。
• 检查Tab键行为，默认缩进宽度是4个空格，如果你写代码习惯2空格缩进，改成2不会花一分钟。
• 打开左侧边栏的“目录”模式，MarkText会根据当前文档标题自动生成大纲，写长文时靠它跳转章节，效率翻倍。

这些配置没有一个是必须抄的，重点是理解你自己要什么。我的建议是初始按这个清单来，用一段时间后再一点点微调，不要一上来追求“完全体”，每个设置项都是手感问题。

3. 日常编辑的高效玩法：快捷键与写作流

3.1 高频快捷键速查表

MarkText的快捷键体系继承了Typora那套肌肉记忆，很多快捷键几乎不用重新学。我把日常高频操作整理成了一张表，建议收藏或者记下来：

从列表能看出，MarkText把很多操作收敛到了几个拇指附近的高频键上。我个人的习惯是加粗、斜体、标题级别这五个键闭着眼睛都能按，其他操作能点菜单就点菜单，没必要为了“用满快捷键”增加记忆负担。

不同系统和键盘布局下快捷键可能有细微差异，如果你按下去没反应，优先看菜单栏对应的功能项，它旁边会直接显示真正生效的快捷键。别硬记我这张表，要以你自己机器上的提示为准。

3.2 表格、代码块和数学公式的实战体验

MarkText对表格的支持比很多开源编辑器好不少，光标放进表格后，你可以像在Word里一样直接增删行列，表格线、对齐方式都会在实时预览里准确显示。这一点我之前对比过几款开源编辑器，很多普及度挺高的编辑器在表格操作上还是“源码模式改半天才对齐”，MarkText在这块确实成熟。

代码块的体验也值得单独说。它支持几十种语言的高亮，常见的javascript、python、bash、cpp都有，语言标识符写在代码块开头。如果你想写行内代码``，直接用反引号包裹，实时预览里会带底色区分，很直观。

数学公式是MarkText的加分项，它用的是KaTeX渲染引擎，支持行内公式和块级公式。行内公式用两个美元符包裹，块级公式用四个美元符独立成段，写出来后排版干净。但注意一个坑：KaTeX并不是支持所有LaTeX语法，你粘贴一段网上抄来的复杂公式，发现渲染不动，多半不是MarkText坏了，而是这个公式用了KaTeX不支持的宏包或语法。这个不要纠结，去查一下KaTeX支持列表，换成等价写法就行。

3.3 打造个人的写作SOP

工具脱离流程就没有意义。我现在的写作SOP很简单，已经稳定用了大半年：

第一步，在MarkText里新建文档，边想边写，用实时预览保证格式不会失控。第二步，标题层级靠快捷键快速敲定，正文用纯段落铺开，列表只出现在真正需要并列信息的地方。第三步，写完最后一轮，打开左侧目录做一次结构检查，把层级混乱的标题调整掉。第四步，导出HTML给需要看的人，或者从HTML再转PDF落档。

这套流程的核心逻辑是把“格式整理”和“内容创作”分离。我见过很多人一边写一边盯着字号边距调整，写了半小时还在开头，这就是工具和流程设计得难受的表现。MarkText的实时预览让我可以先把内容倾泻出来，格式问题放到最后统一处理，效率反而高得多。

4. 进阶扩展：图床、主题与文档导出

4.1 只用一次设置，让笔记里的图片永不丢失

Markdown笔记最怕的一件事，是图片路径失效。默认情况下，你往MarkText里粘贴或者拖入一张图片，它会把图片复制到本地某个路径，并在文章里写一个相对引用。这个方式单机自用没问题，但你一旦换电脑、移动文件夹、或者把md文件发给别人，图片就变成一张裂开的小图标。

MarkText在偏好设置的“图片”一栏里提供了图片上传器，可以把你粘贴进来的图片自动上传到图床，正文里保存的是图床地址。这样文档即使被拷贝到任何地方，图片都能正常显示。我用的是常见的对象存储方案，链路是MarkText上传到云端对象存储，然后通过绑定的CDN域名访问。

配置的时候最容易踩的坑是自定义命令的返回格式。MarkText要求上传命令返回一个特定结构的JSON，你如果用自建脚本，必须严格按约定输出，否则会提示上传失败。排查思路很简单：先把命令单独在终端里跑一遍，看返回是不是合法JSON，再回MarkText里测试粘贴图片。另外，传图前务必确认图片内容可以公开，图床和对象存储本质上是公网资源，不要把身份证截图这类隐私文件扔上去。

4.2 用自定义CSS改出个性化界面

MarkText的界面和主题由CSS控制，所以理论上你能把它改得完全不像默认模样。但我不建议新手一上来就折腾CSS，最容易出现的问题是改错一个括号，界面初始化失败，只能去翻配置目录。

如果你确实想个性化，走一条稳妥的路：从内置主题里挑一个顺眼的，比如One Dark、Dark、Light这些，然后只做“最小改动”。所谓最小改动，就是只碰三个地方——编辑器字体、代码块背景色、标题颜色，其他一律不碰。具体做法是把一个自定义主题文件放到MarkText的主题目录，重启之后在主题里选中它。

有一点必须提醒：升级MarkText时，自定义主题文件可能因为目录结构变化失效。所以改完主题后记得备份一份到自己的笔记目录里，省得哪天重装系统后还得重新琢磨一遍。主题这个东西是“锦上添花”，别让美化占据你本来用于写作的时间。

4.3 导出PDF与HTML的一些细节

MarkText的导出入口在文件菜单里，支持导出HTML和PDF。我用下来有个直观感受：导出PDF的本质是调用Chromium打印，效果和编辑器里看到的基本一致，但页面边距、打印缩放这些参数经常需要单独调。很多新手在这儿踩坑：预览文档好好的，导出PDF后页边距大得离谱，或者表格被截断。

我的应对方案是：先导出HTML，再用浏览器打开并调用浏览器自己的打印功能，在打印设置里手动调整页边距、纸张、缩放比例。浏览器打印的所见即所得程度比MarkText内部导出更可控，导出正式文档和打印纸质资料时尤其推荐这个流程。

如果你只是给同事或者客户快速看内容，导出HTML发过去就完事，大多数现代浏览器和手机都能直接打开，不用额外装PDF阅读器。这个技巧看起来小，实际能省很多沟通成本。

5. 踩坑实录：那些官方文档没写的问题

5.1 高频问题排查速查表

两年用下来，MarkText踩过的坑零零散散有很多，我把最常遇到的整理成了速查表：

这份表里能看出问题的共性：很多故障并不是MarkText本身崩溃，而是外部环境、网络、字体、输入法这些周边因素。排查顺序永远是从外部到内部，先看网络与配置，再看软件本身，不要一上来就重装。

5.2 几个不常被提到的独家心得

MarkText有个容易被忽略的写作辅助：焦点模式和打字机模式。焦点模式会把当前正在编辑的段落高亮，其他段落变暗，干扰感大幅下降；打字机模式让当前行始终保持在屏幕中央，长时间写作时脖颈和眼睛的压力会小一点。我个人习惯是写长文两个都开，写短笔记则只开焦点模式。

还有一个建议是，不要试图在MarkText里打开超大的目录当工作区。MarkText打开文件夹后会在侧边栏展示文件树，但上千个文件的目录会让文件树加载变慢，而且修改外部新加入的文件时，侧边栏不会自动刷新，容易造成“明明文件在，侧边栏里看不到”的困惑。我的做法是：一个笔记项目一个文件夹，文件夹里的md文件保持在可管理的范围内，工作区模式只用于日常整理，写具体内容时从侧边栏直接点开单文件。

关于插件，MarkText没有太丰富的插件生态，很多人觉得这是缺点，但我不太在意。笔记工具的核心诉求是“写下来、存得住、导得出”，这三个需求MarkText都满足了。真需要自动化处理md文件，我通常用外部脚本批量操作，写Markdown本身这件事，交给一个纯粹、稳定的编辑器反而是最优解。

最后说点个人的取舍吧。我中间试过搬到更“现代”的笔记软件，页面更漂亮、同步更智能、生态更热闹，但兜兜转转还是把MarkText换回来了，原因很朴素：笔记是纯文本md文件，格式和图片都在本地，任何其他工具都能随时读取和迁移。MarkText不是最精致、更新最快、功能最全的编辑器，但它是我用下来最省心的那一个——打开就能写，导出就走人，不折腾。

如果你也是把笔记当成长期资产的人，不妨照着上面的步骤先配好一台主力编辑器，遇到不确定的地方再回来翻这篇。快捷键、主题、图床这些经验都可以照抄，踩坑那一段建议直接存档，这些问题我基本都替你试过了。