目录 (11)
博客简介 – 编辑器
大家好,这是我的第一篇博客文章。
我创建这个博客,是为了记录并分享自己在编程过程中思考和解决问题的过程。虽然我不太擅长写文章,但我会不断修改、完善,努力更高效地分享知识。
这篇文章我想介绍一下我亲手打造的博客编辑器。
我花了将近 1 个月测试了各种编辑器,最终选择了基于 ProseMirror 的 Tiptap。
Tiptap 的特点是:
扩展性出色
Viewer 无论是 JSON 还是 Text 格式都可以 SSR
与 Next.js & 后端搭配得很好
编辑器 | SSR | 扩展性 | 引擎 | WYSIWYG | Markdown | RIch Text | 其他 |
|---|---|---|---|---|---|---|---|
editor.js | 🟡 | ↗️ | 自有 | ✅ | 🟡 | ✅ | 文档好。JSON 结构。 |
react-md-editor | ❌ | ➡️ | 自有 | ❌ | ✅ | ❌ | 所见即所得(WYSIWYG)的易用性不好。 |
toast UI | ❌ | ⬇️ | ProseMirror | ✅ | ✅ | ✅ | 文档差。插件少。 |
quill | 🟡 | ↗️ | Delta | ✅ | 🟡 | ✅ | 文档好。JSON 结构。 |
TipTap | ✅ | ↗️ | ProseMirror | ✅ | 🟡 | ✅ | 文档一般。功能划分清晰。 |
ProseMirror | ✅ | ⬆️ | 自有 | ✅ | ❌ | 🟡 | 文档最好。学习曲线陡峭。 |
👉 结论:如果以简单功能为主,推荐 Quill/Editor.js。但如果需要大量自定义功能,Tiptap/ProseMirror 应该是最佳选择。
1. 功能定义
我整理了一下我的编辑器需要的功能。
基本文本编辑功能
更改字体样式(加粗、下划线、斜体、颜色、背景色)
项目符号、编号、清单
段落左对齐、右对齐、居中对齐
支持 Markdown 语法(输入 # 再加空格就是 h1 标签.. 输入 ```js 时自动生成 js 代码块)
缩进、减少缩进
创建超文本链接
Viewer 的服务端渲染
Viewer 支持服务端渲染(SSR),因此可以通过 NextJs 的 ISR、SSG 进行缓存
代码块与代码高亮
根据代码块中设置的编程语言进行语法高亮
Code Syntax Highlighter 支持 SSR,因此可以通过 NextJs 的 ISR、SSG 进行缓存。
在基本的 Syntax Highlighted 代码上添加格式。(荧光笔、下划线等)
从 VS Code 复制的代码会自动识别该文件的语言并生成代码块
图片上传与管理
支持图片对齐和调整大小功能
复制粘贴时可以方便地上传到 S3,并获取 URL 来使用
上传时先进行 WebP 压缩再比较,选用更高效的格式。
复用已有的图片 URL,避免不必要的上传。
自动生成目录(TOC)
根据标题自动生成目录(TOC)
开头斜杠、拖选自动补全
输入“/”就可以使用主要功能。
拖选内容后,可以对所选区域使用需要的功能。
2. 功能介绍
下面简单介绍一下实现这 6 项功能时遇到的困难以及实现方法。
2.1 Code Syntax Highlighter
开发原因:因为是技术博客,必须支持多种语言的代码高亮
实现:基于 Shiki,支持 100+ 种语言,按 Line 单位解析 → 可以处理 Line number
特点:代码块中也可以应用荧光笔·下划线
·删除线等标记。可自动识别从 VS Code 复制粘贴的代码语言。困难:解决 ProseMirror Schema/Mark 冲突 → 花了 2 周以上
成果:与编辑器浑然一体地运行(与编辑器上下文联动),无需重复存储数据

2.2 Viewer 的服务端渲染
开发原因:通过 Next.js ISR/SSG 缓存实现快速渲染
构思过的方案:
由客户端传递 HTML → 可能存在安全隐患。
在服务器端通过 SSR 进行数据解析和 Sanitizing → 反映最新内容,安全
实现:服务器端存储数据 + 同时缓存解析后的 HTML → 输出快速且安全
优点:增强安全性,无需重复存储数据
2.3 图片上传

开发原因:需要将图片实时上传到 S3 存储。
实现:粘贴剪贴板 → WebP 压缩 → 上传到 S3 后返回 URL
困难:如何处理外部 URL,以及如何设置 CSP
优点:复用已有 URL → 避免重复上传
2.4 基本文本编辑功能
![]() | ![]() |
实现:按照 Tiptap 的规范开发插件
困难:要添加功能,甚至还得参考 ProseMirror 的文档。
优点:随时都可以通过添加功能来扩展排版装饰的自由度。
2.5 TOC

开发原因:很羡慕 NamuWiki 那种通过目录跳转的功能。
实现:
在 Heading 插件中添加用于 TOC 的 data-attribute,并利用它进行解析。
通过 ResizeObserver 检测 Layout 变化,并应用 Debouncing 进行优化。
困难:因为是通过解析的方式实现的,如果不了解编辑器 Heading 插件的实现细节,就很难维护。
优点:可以一眼看到目录并快速找到内容。
2.6 开头斜杠、拖选自动补全
![]() | ![]() |
开发原因:参考了 Notion 编辑器,觉得它已经足够好用。
实现:
幸好已有基础插件,于是直接利用了该插件
把想要自定义添加的功能加到了插件中。
困难:需要先弄清所有 Command 再进行添加,但代码块是从零开始做的功能,所以必须手动添加命令。
优点:不用把鼠标移到控制框那里,很方便。
3. 其他功能
3.1 Iframe (CodePen)
开发原因:总有一天要能展示代码的运行效果,我觉得利用 CodePen 会很不错。
实现:
应用 iframe 时可能会产生安全问题,所以适当地使用了 CSP。
困难:因为完全是 Third Party,受 CSP 的影响很大,但在实际环境中很难测试。




