編輯工具
自動完成與斜線命令
感知套件的 LaTeX 命令、Typst 函式與套件、引用細節、檔案路徑、數學捷徑,以及可重複使用的程式碼片段。
在 LaTeX 中,編輯器會在你輸入時完成三件事:命令、交互參照與引用。再加上用於結構的 / 斜線選單,大多數文件都不必再手打固定格式的內容。Typst 檔案有自己的自動完成與程式碼片段,說明請見 Typst 自動完成。
輸入時會自動出現建議;Ctrl+Space 可在任何地方叫出建議。按 Tab 或 Enter 接受。
命令自動完成
標題為「命令自動完成」的段落輸入反斜線後繼續打:\sec… 會提供 \section,\fra… 會提供 \frac。自動完成取材自廣泛的 LaTeX 命令目錄與專案所用的套件,也包含你原始碼中的自訂命令與環境。
自動完成會以帶有 Tab 停駐點的程式碼片段插入:接受 \frac 後會得到 \frac{│}{},游標在分子位置;按 Tab 會跳到分母。\itemize、\enumerate、\equation、\align 這類環境的自動完成,會插入整個 \begin…\end 區塊,游標位於其中。
參照自動完成
標題為「參照自動完成」的段落在 \ref{、\eqref{、\pageref{、\autoref{、\cref{ 或 \Cref{ 內,選單會列出文件中定義的每個 \label{}。不必再往上捲動去回想你把它叫做 fig:arch 還是 fig:architecture。

引用自動完成
標題為「引用自動完成」的段落在 \cite{ 及其變體(\citep、\citet、\citeauthor、\citeyear、\parencite、\textcite)內,選單會列出專案 .bib 檔案中的引用鍵;這些檔案在專案開啟時會自動解析。
如果論文還不在你的 .bib 裡,就該用引用查詢:貼上 DOI 或標題,Oleafly 會一步完成加入條目與 \cite。
數學與結構
標題為「數學與結構」的段落輸入 $、\( 或 \[ 時,會自動插入對應的結尾分隔符號。游標到達自動插入的結尾 $ 時,再輸入一次 $ 即可越過它。括號在行內公式中會成對出現,在分隔符號之間按 Enter,空的 $$ 會變成行間公式。
接受清單環境時,會插入它的第一個 \item。在項目結尾按 Enter 可繼續清單,包括描述標籤或巢狀清單的縮排。按 Shift+Enter 可只換行;讓新項目保持空白,再按一次 Enter 即可結束清單。
如果你自己輸入了尚未關閉的 \begin{...},按 Enter 會補上對應的 \end{...}。用 ⌘⌥.(Ctrl+Alt+.)關閉最內層仍開啟的環境,或用 ⌘⌥E(Ctrl+Alt+E)把選取內容包進一個環境。在數學中輸入 @ 可瀏覽希臘字母與其他符號。
當成功建置後取得編號時,參照建議會包含編譯出來的編號。引用建議則有助於辨識某個鍵背後的論文。
控制自動關閉的內容
標題為「控制自動關閉的內容」的段落想要更少或更多的自動輸入時,請開啟 設定 → 外觀 → 編輯器:
- 自動完成 會在你輸入時顯示建議。關閉此項時,Ctrl+Space 仍可開啟建議。
- 自動關閉括號 會插入成對的括號。
- 自動關閉數學符號 會為
$、\(與\[配上對應的分隔符號。 - 自動關閉環境 會在你於
\begin{...}之後按 Enter 時,插入對應的\end{...}。
只關閉與你寫作方式衝突的輔助功能就好。手動自動完成、關閉環境與包覆的快捷鍵仍然可用。
斜線選單
標題為「斜線選單」的段落在任何地方輸入 / 就會開啟插入選單,並隨著輸入即時篩選:
| 命令 | 插入內容 |
|---|---|
/section、/subsection | 章節命令 |
/itemize | 項目符號清單 |
/enumerate | 編號清單 |
/item | 一個清單項目 |
/equation | 行間方程式環境 |
/align | 對齊的多行方程式 |
/frac | 分數 |
/figure | 含 \includegraphics 與 \caption 的完整圖片浮動體 |
/table | 含起始 tabular 的表格浮動體 |
/bold、/italic | \textbf{}、\textit{} |
/label | \label{} |
/usepackage | \usepackage{} |
所有項目都以帶有 Tab 停駐點的程式碼片段插入,因此按 Tab 就能依序填寫空白處(先是圖說,接著是標籤,然後繼續往下)。
Typst 自動完成
標題為「Typst 自動完成」的段落Typst 檔案有自己的自動完成,主要來自 Tinymist,這是與專案 Typst 版本相符的 Typst 語言伺服器。
| 輸入的位置 | 選單提供的內容 |
|---|---|
# 後面接名稱 | 函式與變數 |
在 image(、read(、csv(、json(、yaml(、toml( 或 bibliography( 內的字串,或位於 #include 或 #import 之後 | 專案檔案路徑 |
@,或在 ref( 或 cite( 內輸入 < | 標籤與引用鍵,來自 .bib 與 Hayagriva .yml 檔案 |
#import "@preview/ | 來自 Typst Universe 的套件 |
#bibliography(...) 或 #cite(...) 中的 style: | 參考文獻樣式名稱,專案自己的 .csl 檔案排在最前面 |
在行首或空格之後輸入 /,可取得 Typst 程式碼片段:/heading、/figure、/tablefigure、/table、/equation、/numberedequation、/footnote、/quote、/code、/outline、/bibliography、/pagebreak、/columns、/grid、/link、/list、/enum 和 /terms。在 Typst 0.15 與更新版本中,/partbibliography 會為文件的某一部分加入參考文獻。
Typst 數學與清單
標題為「Typst 數學與清單」的段落在文字中輸入 $ 時,也會一併插入結尾的 $。在空的一對符號中輸入空格,可得到行間公式 $ | $;在空的一對符號中按 Backspace 則會同時移除兩個符號。選取文字後輸入 *、_、反引號或 $,會包覆選取內容而不是取代它。這些行為依循上述 自動關閉括號 與 自動關閉數學符號 設定。
在清單中,Enter 會開始下一個 -、+、/ 或編號項目。在空項目上按 Enter 會移除它的標記,Shift+Enter 則在新的一行繼續目前的項目。Tab 會把項目縮排到上一個項目之下,Shift+Tab 則會把它移回外層。
值得注意的事
標題為「值得注意的事」的段落- Tab 身兼兩職:有開啟的建議時用來接受建議,否則用來縮排。
- 點選其他地方時,自動完成選單會關閉;也可以按 Esc 明確關閉。
- 在
\input{}與\includegraphics{}這類支援的命令內,會自動完成專案檔案路徑。