文章编辑器全功能特性手册
面向作者的完整功能参考。编辑器为 Tiptap 富文本(WYSIWYG),保存时双写:content_html(展示权威源,保留下划线/颜色/高亮/对齐等样式)与 content_md(Markdown 源,降级展示/导出用,有损——见第 11 节)。
用法:本文档本身就是一份「可直接粘贴的演示」。新建文章 → 全选复制本文档原文(含 $、 $$、代码块、表格等)→ 粘贴保存 → 在前台逐项比对渲染效果。文档中的所有公式均为真实可渲染的 LaTeX,不是「源码↔预期」两列对照。
1. 文本样式
效果 | Markdown 语法 | 快捷键 | 备注 |
|---|
加粗 | **文本**
| Cmd/Ctrl+B
| |
斜体 | *文本*
| Cmd/Ctrl+I
| |
下划线 | 无 Markdown 表达 | Cmd/Ctrl+U
| 仅存 content_html |
删除线 | ~~文本~~
| Cmd/Ctrl+Shift+S
| |
行内代码 | `代码`
| Cmd/Ctrl+E
| |
高亮 | ==文本==
| 工具栏高亮按钮(多色) | 颜色仅存 content_html |
文字颜色 | 无 Markdown 表达 | 顶部工具栏色板 | 仅存 content_html |
链接 | [文字](https://…)
| 工具栏/气泡菜单 | 裸 URL 自动识别为链接(autolink) |
对齐 | 无 Markdown 表达 | 工具栏(左/中/右/两端) | 作用于标题与段落 |
入口提示:颜色选择在顶部工具栏色板;气泡菜单(选中文本时浮出)只有「粗体 / 斜体 / 行内代码 / 链接」四项。
2. 标题与目录
支持 H1–H4 四级标题,语法为 # / ## / ### / #### 加空格。
文章页自动渲染目录(TOC),提取 H2 / H3 / H4(H1 不进目录),锚点可点击跳转,滚动时高亮当前章节。
正文内 #+空格快捷生成标题;H1–H3 也可走 Slash 菜单。
3. 列表
无序(-/*/+ 加空格)、有序(1. 加空格)、任务(- [ ] / - [x] 加空格)。
任务列表在文章页渲染为可读勾选框(只读)。
列表内 Tab/Shift+Tab 缩进/反缩进。
4. 引用与分割线
引用块用 > 行首触发;分割线用 --- 触发。
5. 代码块
行首输入 ``` 加语言名(如 javascript、go)再回车,或 Slash 菜单「代码块」插入。
编辑器右上角下拉切换语言;前台按语言高亮,并显示语言标签与复制按钮。
6. 图片
工具栏「图片」下拉 / Slash 菜单「图片」→ 本地上传或素材库。
上传走分片通道(purpose=post),支持秒传与断点续传。
文章页自动走 w=1200 缩略(GIF 保动画),点击看原图。
Markdown 语法  同样有效。
7. 表格
Slash 菜单或工具栏「表格」插入 3×3 空表(带表头)。光标进入表格后顶部出现表格工具栏:增删行列、合并/拆分单元格、删除整表。
8. 数学公式
渲染核心为 KaTeX + mhchem 扩展 + 项目物理宏表。本节每一条都是可直接渲染的真实 LaTeX——把本节整段贴入编辑器,应该看到对应的符号/公式排版,而不是命令名文本。
8.1 两种形态与输入规则
形态 | 渲染示例 | 输入方式 |
|---|
行内公式 | 质能方程 E=mc2 著名 | Slash「行内公式」,或粘贴 $E=mc^2$ |
公式块 | 见下方示例 | Slash「公式块」,或粘贴 $$...$$ |
键入提示:手动键入时,编辑器的即时转换规则是 `
(行内)与
$
‘(块,行首三美元);单‘...$在键入时不会即时转换,但**粘贴或 Markdown 导入时**会被@tiptap/markdown` 正常识别为行内公式。手动插入最稳的方式是走 Slash 菜单。
$100、$5 美元 这类货币写法不会误触公式。点击公式进入编辑态(源码 + 实时预览),Esc/Enter 退出。
8.2 基础结构(真实渲染)
上下标同挂:xi2、an、x2
分数与展示型分数:ba、ba
根号与 n 次根:x、3x
分数作指数(嵌套):x21
二项式系数:(kn)
8.3 希腊字母与常用符号
小写(含变体):
αβγδϵεζηθϑικλμνξπϖρϱσςτυϕφχψω
大写:
ΓΔΘΛΞΠΣΥΦΨΩ
关系与集合:
∞∂∇±∓×÷⋅≤≥=≈≡∼∝
∈∈/⊂⊆⊃⊇∪∩∅∀∃¬∧∨⇒⇔→↦
ϵ 与 ε、ϕ 与 φ 形状不同——粘贴本行可见两种字形对照。
8.4 大型运算符(上下限)
i=1∑ni=2n(n+1)k=1∏nk=n!x→0limxsinx=1 ∫01x2dx=31∮CF⋅dr=0i=1⋃∞Aii=1⋂∞Bi 行内公式里大运算符的上下限会压缩到侧边:∑i=1ni、∫01xdx;块级则在正上下方。
8.5 函数名与对数三角
sin2x+cos2x=1tanx=cosxsinx log2n+lnx+lg100exp(x)⋅max(a,b)⋅min(a,b)rank(A)=3 函数名为直立体(不斜),\operatorname{} 可定义任意直立函数名。
8.6 括号与定界符
圆 / 方 / 花 / 角 / 双竖括号(花括号须转义):(x)、[x]、{x}、⟨x⟩、∥x∥
括号随内容自动放大:(ba)、[ba]
左大括号右空(\right. 不可见闭合):{x∣x>0
物理宏自动缩放圆括号:(()ba)
8.7 标注、帽子与向量
v+AB+k^x^+xˉ+x˙+x¨+x~ ABABa+b+c项数合计x+y+z \vu 为物理宏单位向量(自动带帽子)。
8.8 矩阵与分段函数(全族环境)
裸矩阵 / 圆括号 / 方括号:
acbd(acbd)[acbd] 花括号 / 单竖线 / 双竖线:
{acbd}acbdacbd 分段函数与方程组:
f(x)={x2−xx≥0x<0{x+y=3x−y=1 行分隔 \\、列分隔 &。矩阵行尾的 \\ 是合法语法不是污染——清洗反斜杠双写时务必保留。
8.9 对齐与多行
∇×B∇×E=μ0J+μ0ε0∂t∂E=−∂t∂B a=b+c+d=e+f+g aligned 按 & 对齐(通常放等号前);gathered 各行居中。
8.10 字体与文本
R⊃Q⊃ZF=madxL=T−V \text{} 内可排中文与混合文字:x(其中 x≥0)。
8.11 空格
语法 | 渲染 | 含义 |
|---|
a\,b
| ab | 窄空格(thin) |
a\;b
| ab | 中空格(medium) |
a\ b
| a b | 标准空格 |
a\quad b
| ab | 宽空格 |
a\qquad b
| ab | 更宽 |
8.12 化学(mhchem 全语法)
分子式与离子
水、葡萄糖、硫酸:HX2O、CX6HX12OX6、HX2SOX4
离子电荷:SOX4X2−、NaX+、CaX2+
同位素:X14X2214C、X235X22235U、X2X222H
配位化合物:[Cu(NHX3)X4]X2+、[Fe(CN)X6]X4−
反应方程式
2HX2+OX22HX2O NX2+3HX22NHX3 CaCOX3ΔCaO+COX2↑ NaCl(aq)+AgNOX3(aq)AgCl↓+NaNOX3(aq) CHX4+2OX2COX2+2HX2O -> 反应箭头、<=> 可逆箭头、^ 气体符号、v 沉淀符号、[\Delta] 反应条件、(g)/(l)/(aq) 物态标注——分子式中字母均直立体,不斜。
物理单位
9.8 m/s2、1.6⋅10−19 C、298 K、6.022⋅1023 /mol、3.0⋅108 m/s
\pu{} 输出直立体单位、自动处理科学计数与下标。
8.13 物理宏表(项目内置,全清单)
源码 | 渲染 | 含义 |
|---|
\RR \ZZ \NN \QQ \CC
| RZNQC | 实数 / 整数 / 自然数 / 有理数 / 复数集 |
\dd{x}
| dx | 直立体微分 d |
\dv{f}{x}
| dxdf | 莱布尼茨导数(双参数) |
\pdv{f}{x}
| ∂x∂f | 偏导(双参数) |
\bra{\phi} \ket{\psi} \braket{\phi}{\psi}
| ⟨ϕ∣ ∣ψ⟩ ⟨ϕ∣ψ⟩ | 狄拉克左矢 / 右矢 / 内积 |
\expval{H}
| ⟨H⟩ | 期望值(角括号) |
\abs{x} \norm{v}
| ∣x∣ ∥v∥ | 绝对值 / 范数(自动缩放) |
\vu{i}
| i^ | 单位向量(带帽子) |
\grad \divg \curl
| ∇ ∇⋅ ∇× | 梯度 / 散度 / 旋度 |
\qty(\frac{a}{b})
| (()ba) | 自动缩放圆括号 |
刻意差异:\div 仍是除号 ÷(不覆写),散度必须用 \divg;\dv / \pdv 为双参数形态(不支持 physics 包的单参数算子形态)。
8.14 综合实例(物理)
牛顿第二定律与万有引力
F=maF=Gr2m1m2G≈6.674⋅10−11 Nm2/kg2 麦克斯韦方程组(微分形式)
∇⋅E∇⋅B∇×E∇×B=ε0ρ=0=−∂t∂B=μ0J+μ0ε0∂t∂E 麦克斯韦方程组(积分形式)
∮∂VE⋅dA∮∂VB⋅dA∮∂SE⋅dl∮∂SB⋅dl=ε0Qenc=0=−dtd∫SB⋅dA=μ0Ienc+μ0ε0dtd∫SE⋅dA 薛定谔方程(含时)
iℏ∂t∂Ψ(r,t)=[−2mℏ2∇2+V(r,t)]Ψ(r,t) 定态薛定谔与本征值方程
H^ψn=Enψn∣ψ⟩=n∑cn∣n⟩ 爱因斯坦场方程
Gμν+Λgμν=c48πGTμν 狄拉克方程(协变形式)
(iℏγμ∂μ−mc)ψ=0 洛伦兹变换与能动量关系
Δt′=1−v2/c2ΔtE2=(pc)2+(m0c2)2 拉格朗日量与欧拉-拉格朗日方程
L=T−Vdtd∂q˙i∂L−∂qi∂L=0 哈密顿量
H(q,p,t)=i∑q˙ipi−Lq˙i=∂pi∂Hp˙i=−∂qi∂H 热力学四大方程(简单形式)
dU=δQ−δWdH=TdS+VdPdF=−SdT−PdVdG=−SdT+VdP 理想气体状态方程
PV=nRTR≈8.314 J/(mol⋅K) 8.15 综合实例(数学分析)
泰勒级数
ex=n=0∑∞n!xn=1+x+2!x2+3!x3+⋯ sinx=n=0∑∞(2n+1)!(−1)nx2n+1cosx=n=0∑∞(2n)!(−1)nx2n ln(1+x)=n=1∑∞n(−1)n+1xn(∣x∣<1) 傅里叶级数
f(x)=2a0+n=1∑∞(ancosLnπx+bnsinLnπx) an=L1∫−LLf(x)cosLnπxdxbn=L1∫−LLf(x)sinLnπxdx 高斯积分
∫−∞∞e−x2dx=π∫−∞∞e−ax2dx=aπ(a>0) 欧拉公式与欧拉恒等式
eiθ=cosθ+isinθeiπ+1=0 黎曼 Zeta 函数
ζ(s)=n=1∑∞ns1ζ(2)=n=1∑∞n21=6π2 柯西不等式
(i=1∑naibi)2≤(i=1∑nai2)(i=1∑nbi2) 留数定理(柯西积分公式)
f(a)=2πi1∮γz−af(z)dz∮γf(z)dz=2πi∑Res(f,ak) 二项式定理
(x+y)n=k=0∑n(kn)xn−kyk 斯特林公式
n!∼2πn(en)n 8.16 综合实例(线性代数)
行列式(3 阶)与莱布尼茨公式
det(A)=adgbehcfi=aei+bfg+cdh−ceg−bdi−afh det(A)=σ∈Sn∑sgn(σ)i=1∏nai,σ(i) 特征值方程
det(A−λI)=0Av=λv 协方差矩阵
Σij=cov(Xi,Xj)=E[(Xi−μi)(Xj−μj)] 矩阵乘法
Cij=k=1∑nAikBkj(AB)T=BTAT 正交投影
P=A(ATA)−1ATP2=P 奇异值分解
A=UΣVTA∈Rm×n, Σ=diag(σ1,…,σr) 8.17 综合实例(概率统计)
贝叶斯定理
P(A∣B)=P(B)P(B∣A)P(A)=∑iP(B∣Ai)P(Ai)P(B∣A)P(A) 全概率公式与期望
P(B)=i∑P(B∣Ai)P(Ai)E[X]=x∑xP(x) 二项分布
P(X=k)=(kn)pk(1−p)n−kE[X]=np, Var(X)=np(1−p) 正态分布
f(x)=σ2π1exp(−2σ2(x−μ)2) Φ(x)=2π1∫−∞xe−t2/2dt 中心极限定理
nσXˉn−μdN(0,1)当 n→∞ 协方差与相关系数
cov(X,Y)=E[(X−μX)(Y−μY)]ρX,Y=σXσYcov(X,Y) 熵与交叉熵
H(X)=−x∑P(x)logP(x)H(P,Q)=−x∑P(x)logQ(x) 8.18 综合实例(量子力学)
对易子与不确定关系
[A^,B^]=A^B^−B^A^[x^,p^]=iℏ Δx⋅Δp≥2ℏ 自旋算符(泡利矩阵)
σx=(0110)σy=(0i−i0)σz=(100−1) 期望值(狄拉克记号)
⟨A⟩=⟨ψ∣A^∣ψ⟩=∫−∞∞ψ∗(x)A^ψ(x)dx 归一化与正交性
⟨ϕ∣ψ⟩=δij∫−∞∞∣ψ(x)∣2dx=1 一维势阱能级
En=2mL2n2π2ℏ2n=1,2,3,… 谐振子能级
En=ℏω(n+21)n=0,1,2,… 8.19 综合实例(化学综合)
氧化还原配平(高锰酸钾氧化 Fe²⁺)
MnOX4X−+5FeX2++8HX+MnX2++5FeX3++4HX2O 酯化反应(可逆)
CHX3COOH+CX2HX5OH浓硫酸CHX3COOCX2HX5+HX2O 电池反应(铅酸蓄电池)
Pb+PbOX2+2HX2SOX42PbSOX4+2HX2O 缓冲溶液(亨德森-哈塞尔巴尔赫方程)
pH=pKa+log[HA][AX−] 配位化合物命名前驱
[Ag(NHX3)X2]X+[Fe(CN)X6]X3−[Co(NHX3)X6]X3+ 热化学方程式
C(s)+OX2(g)COX2(g)ΔH=−393.5 kJ/mol 8.20 错误容错
故意写错的公式 $\frac{1$(缺右括号)→ 不白屏、不打断页面:公式位置渲染红色错误标记,其余内容正常。编辑器内同样容错,方便边写边改:
\frac{1 + 2}{3
8.21 注意事项(踩坑高发)
反斜杠不要双写。\\ 是 LaTeX 换行命令(矩阵/aligned 换行靠它)。从 LLM 输出、JSON 接口、部分平台导出拷贝的公式常带 \\pi 双写,渲染出来是命令名文本("pi、varphi、frac")——改回 \ 即可。本项目与 GitHub/Typora/Obsidian 行为一致,不自动折叠。
矩阵/aligned 行尾的 \\ 是合法语法不是污染,清洗双写时务必保留。
花括号是结构符,字面花括号写 \{ \}。
KaTeX 不支持的 LaTeX 宏包(如 physics、siunitx 本体、TikZ)不可用;常用物理命令已由 8.13 宏表覆盖。
9. Markdown 快捷输入(输入规则)
输入即转换,无需菜单:
输入 | 得到 |
|---|
#+空格 / ## / ###
| 标题 |
>+空格
| 引用块 |
-+空格 / *+空格 / 1.+空格
| 列表 |
- [ ]+空格
| 任务列表 |
```+语言+回车
| 代码块 |
---
| 分割线 |
**文本** *文本* ~~文本~~ ==文本== `代码`
| 行内样式 |
$$公式$$(段内)/ $$$公式$$$(行首三美元)
| 公式节点 |
单 $公式$ 在键入时不会即时转换,但粘贴/MD 导入时有效;手动插入走 Slash 菜单最稳。
10. Slash 菜单
任意位置输入 / 唤起,支持关键词/中文模糊搜索。共 14 项,按组:
基础:正文、一/二/三级标题
列表:无序、有序、任务列表
块:引用、代码块、分割线、表格(3×3 带表头)
媒体:行内公式、公式块、图片
H4–H6、对齐、颜色、链接、行内样式、撤销重做等不在 Slash 菜单——只在工具栏/气泡菜单。
11. 存储与有损说明(重要)
content_html 是展示权威源:下划线、文字颜色、高亮颜色、对齐这些 Markdown 表达不了的样式只存在这里,文章页始终正确。
content_md 是有损的:上述样式在 Markdown 导出/降级展示时会丢失(加粗/斜体/删除线/高亮标记保留)。公式、代码块、表格、任务列表、图片在两条路径间无损往返(round-trip 测试保障)。
旧 Markdown 文章走降级渲染路径(react-markdown + remark-math),公式渲染与主路径同一套 KaTeX 组件,视觉一致。
12. 暂不支持
流程图等图块(Mermaid):已定设计(ADR-0004 图块模型),下期实现。
脚注、上标下标(正文文本)、Wiki 链接、HTML 混排(降级路径不解析原始 HTML)。