說明：下文定界符示例裡的全角「＄」對應編輯器中實際輸入的半形美元符（一塊級兩個、行內一對）；本文用全角書寫，避免 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 圍欄）
