说明:下文定界符示例里的全角「$」对应编辑器中实际输入的半角美元符(一块级两个、行内一对);本文用全角书写,避免 Markdown 导入时被误解析为公式。
1. 两种公式形态
| 形态 | 编辑器类型 | 典型场景 | Markdown |
|---|
| 行内公式 | math(inline) | 句子里的 (a+b)、变量、短式 | $...$ |
| 块级公式 | mathBlock | 独立居中展示的方程、推导 | $$...$$ |
2. 在编辑器中如何插入
| 菜单标题 | 作用 | 常用搜索别名 |
|---|
| 块级公式 | 插入独立数学块 | 数学 / 公式 / 方程 / latex |
| 行内公式 | 在光标处插入行内公式 | 数学 / 公式 / 方程 / latex |
2.1 斜杠菜单(推荐新手)
- 在段落中输入 /
- 输入 公式、数学 或 latex
- 选择:
- 块级公式 → 插入整块,并自动打开源码输入框
- 行内公式 → 插入行内节点,并自动打开源码输入框
- 输入 LaTeX(例如 E = mc^2),失焦或确认后显示渲染结果
2.2 快捷输入规则(熟练后更快)
| 输入 | 效果 |
|---|
| $$ + 空格 | 当前块变成空的 mathBlock |
| \[ + 空格 | 同上(LaTeX display 习惯) |
行内公式(在正文中边打边转,打完结尾定界符即触发,无需再输入空格,与块级不同):
| 输入 | 效果 |
|---|
| $...$ | 中间内容变成行内公式 |
| \(...\) | 同上(LaTeX inline 习惯) |
示例:输入 $a+b$ 后,编辑器会把 a+b 收成行内公式节点(定界符本身会被去掉)。
2.3 工具栏块类型
选中块后,格式工具栏的 块类型下拉 中有 「公式」,也可切换为块级公式。
3. 如何编辑与预览
- 插入后:弹出源码输入框,占位示例多为 E = mc^2
- 已有公式:点击公式 → 再次打开源码编辑
- 预览:输入合法 LaTeX 后实时渲染;非法公式会提示类似 「无效的公式(点击编辑)」
- 块级:整行/整块展示;行内:嵌在文字中间,高度随文字行
- 行内公式插入后,编辑器会在后面留一个空格,方便把光标移出公式继续打字
- 改公式时点公式本体,不要在旁边的普通文字里「假装」修改
- 复杂式子建议先在块级公式里写好,再决定是否改成行内
4. Markdown 中的写法
| 形态 | Markdown | 对应块 |
|---|
| 块级 | $$ … $$ | mathBlock |
| 行内 | $ … $ | |
TEXT
TEXT
说明:导出时块级可能经 math 代码围栏中转,再还原为 $$;日常写作直接用 $ / $$ 即可。
5. 常用四则运算(标准符号)
在数学排版里,不要用键盘上的 *、/、x 当正式乘除号。推荐 KaTeX/LaTeX 标准写法:
| 运算 | 含义 | 推荐 LaTeX | 渲染效果(概念) | 避免 |
|---|
| 加 | 加法 | a + b | (a + b) | — |
|
5.1 可直接粘贴练习
TEXT
TEXT
TEXT
TEXT
5.2 正负号与减号
- 二元减法:a - b
- 负号:-a 或 (-a)
- 加减连写:a \pm b → (\pm);a \mp b → (\mp)
TEXT
6. 更多常用符号速查
| 类别 | LaTeX | 说明 |
|---|
| 上下标 | x^{2}、a_{n} | 多字符必须用 {} |
| 根号 | \sqrt{x}、\sqrt[3]{x} | |
TEXT
TEXT
7. 需要注意的问题
7.1 $ 与货币、普通美元符
行内规则会把 $...$ 收成公式。正文里写价格时注意:
- 可能误触发:价格为 $12$ 会被当成公式
- 实务建议:货币写成 12 美元,或避免成对 $
(代码注释里也提到:与 BlockNote 相同约定,货币误判可接受。)
7.2 块级触发必须在行首
$$ + 空格、\[ + 空格 只在段落开头生效。写在句中不会变成块级公式。
7.3 花括号成对且必要
| 错误 | 正确 |
|---|
| x^10(常变成 (x^1 0)) | x^{10} |
| \frac a b(偶发歧义) | \frac{a}{b} |
| \sqrt x+1 | \sqrt{x+1} |
7.4 乘除符号要「数学符号」
| 场景 | 不推荐 | 推荐 |
|---|
| 乘 | *、x、X | \times 或 \cdot |
| 除 | 仅用 / 表示正式算式 | |
7.5 空公式与非法公式
- 空内容:不渲染或占位「添加 LaTeX 公式」
- 语法错误:显示无效提示,点击即可改,不必删块重建
7.6 行内 vs 块级可读性
- \sum、\int、高大的 \frac 放行内会撑乱行高 → 优先块级
- 单个变量、短式 n+1 → 行内更自然
7.7 反斜杠与换行
- 命令以 \ 开头:\times、\frac
- 块级公式里可用换行;需要对齐环境时再用 aligned 等(进阶)
TEXT
KaTeX 支持常用宏,但不是完整 TeX;过偏的宏包命令可能无效。
7.8 与 Markdown 导入导出
- 块级:$$...$$ ↔ mathBlock
- 行内:$...$ ↔ inline math
- 不要用普通代码块冒充公式(除非语言是内部桥接用的 math 围栏)