# エディタ

ソース編集とビジュアル編集、文書ツール、下書きの横に表示される PDF を使って、LaTeX、Typst、Markdown を書きます。

Oleafly は、ソース編集、文書内の移動、PDF プレビューをひとつのワークスペースにまとめています。CodeMirror ベースのエディタが LaTeX、Typst、Markdown に対応しています。行番号、括弧の対応表示、アクティブ行のハイライトは常にオンです。長い行は折り返されますが、 **設定 → 外観 → エディタ**で**長い行を折り返す**をオフにすると折り返しません。

以下のショートカットは macOS のキーを先に示しています。Windows と Linux では、⌘ を Ctrl と読み替えてください。

![Oleafly で開いた LLaMA。左にファイルツリー、中央に LaTeX のソース、右にコンパイルされた論文があります。](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-writing-dark-window-v2.png)

## 書き方のガイドを選ぶ

ドキュメントエンジンごとに、専用のツールバーとソースの構文があります。次のガイドでは、すべてのコントロールを説明し、貼り付けてコンパイルできる原稿も載せています。

| エンジン | ここから始める |
| --- | --- |
| LaTeX | [構造、書式、引用、図、表、数式、コードのナビゲーション](/docs/writing/latex/) |
| Typst | [見出し、リスト、書式、数式、図、引用、ラベル、コードブロック](/docs/writing/typst/) |
| Markdown | [ソース編集とビジュアル編集、Pandoc の書式、リンク、画像、表](/docs/writing/markdown/) |

## エディタのツールバー

3 つのツールバーは、どれも同じ構成です。

- **コード / ビジュアル**が先頭にあり、開いているファイルをソースと[ビジュアル編集](#visual-editing)の間で切り替えます。
- 次に**元に戻す**と**やり直す**があります。元に戻す操作ややり直す操作がないときは、それぞれグレーアウトされます。
- 中央には書式と挿入のボタンが並びます。収まらないボタンは、どの幅でも**その他の書式設定**（`…`）に移るので、狭いエディタでも操作が失われません。
- 右端には文書ツールが表示されたままになります。**LaTeX パッケージ**または **Typst パッケージ**（[パッケージ](/docs/packages/)を参照）、[文書の分析](/docs/document-insights/)、[文書の設定](/docs/document-settings/)、**プロジェクト情報**、**検索**、**PDF へ移動**です。

Markdown にはパッケージのボタンがありません。これらのツールは ⌘K パレットからも開けます。 **LaTeX パッケージを見る** / **Typst パッケージを見る** / **文書の分析** / **文書の設定**です。

## 現在地を見失わない

スティッキーコンテキストは、スクロールしても、それを囲むセクションや環境を表示し続けます。Typst ファイルでは、カーソルより上の見出しが同じように固定されます。 **設定 → 外観 → エディタ**の**スティッキースクロール**でオフにできます。

`.tex` ファイルと `.typ` ファイルの上にあるパンくずバーには、ファイル名と、カーソルがあるセクションが表示されます。パンくずをクリックすると、その見出しに移動します。プロジェクトのアウトラインは章の間の移動に役立ち、参照と引用のナビゲーションは、シンボルの元になっているソースへ移動します。[オートコンプリート](/docs/autocomplete/)には、パッケージに応じた LaTeX コマンド、数式の入力、引用の詳細が含まれます。

サイドバーの各ビューは、プロジェクトごとにスクロール位置、展開したフォルダ、開いているセクションを記憶するので、同じ場所に戻れます。

![アプリをダークテーマに切り替え、さらにソースと PDF だけの Zen モードに切り替えるところ。](https://cdn.oleafly.com/images/gifs/desktop/theme-zen.gif?v=2)

## Zen モード

Zen モードでは、プロジェクトのツールバー、サイドバー、アシスタント、ターミナル、エディタ自身のタブと書式バーが非表示になります。残るのは書いている文章だけで、エディタは全幅のまま使えます。

macOS では Ctrl+⌘⇧F、Windows と Linux では Shift+F11 を押してオンにします。プロジェクトのツールバーの**レイアウト**メニューか macOS の**表示**メニューで **Zen モード**を選ぶか、⌘K パレットから **Zen モードを切り替え**を実行してもオンにできます。終了するには、同じキーをもう一度押すか、Esc を 2 回押します。

Zen モードでは、 **コンパイル**ボタンは右上の隅に置かれ、PDF が開いている場合はその上に重なります。ポインタを近づけると表示されます。ビルド中は、そこにある小さなラベルに**コンパイル中**と表示されます。ビルドに失敗すると**コンパイルに失敗しました**と表示され、クリックするとコンパイルログの表示と非表示が切り替わります。⌘↵ は引き続きコンパイルし、⌘⌥P は Zen モードのまま PDF を表示または非表示にします。

2 つのオプションは[設定 → 外観 → プロジェクト](/docs/settings/appearance/#zen-mode-settings)にあります。 **全画面にする**は、Zen モードがオンの間、画面全体に表示します。 **コンパイル時に PDF を表示**は、PDF が非表示のときに、コンパイルするたびにエディタの横に PDF を開きます。キー自体は**設定 → キーボードショートカット**で変更できます。

## テーマ、色、フォント

エディタは、アプリがライトのときとダークのときで、別々のテーマを使います。両方のテーマを選び、ソースの各部分の色を変更し、エディタのフォント、サイズ、行の高さ、文字間隔、カーソルを選ぶには、[設定 → 外観 → エディタ](/docs/settings/appearance/#editor-themes)を開きます。別の [CJK フォント](/docs/settings/appearance/#cjk-font)で中国語、日本語、韓国語の文字のフォントを設定できるので、ラテン文字はコーディング用フォントのままにできます。色は、LaTeX、Typst、Markdown で同じ意味を持つ役割に従います。LaTeX では、セクションのコマンドとそのタイトルの両方が見出しの色を使い、引用キーと環境名はそれぞれのコマンドの色になり、数式は 1 色です。`[@key]` や `@key` のような Markdown の引用は、リンクではなく引用として強調されます。

## 検索と置換

⌘F を押すと、エディタの右上に VSCode スタイルのウィジェットが表示されます。

- **大文字と小文字を区別**（`Aa`）、**単語単位で一致**（`ab`）、**正規表現**（`.*`）の切り替え
- リアルタイムの一致数カウンター（`41 件中 3 件目`）。`結果なし` と `不正` の状態があり、巨大な文書では `2000+` で頭打ちになります
- Enter で次の一致に、Shift+Enter で前の一致に移動し、Esc で閉じます
- **一致箇所をすべて選択**は、すべての一致箇所をカーソルにして、同時に編集できるようにします
- 山形のボタンをクリックすると**置換**行が展開されます。次を置換、**すべて**置換、そして**大文字と小文字を保つ**の切り替えがあります。後者は、元の語の大文字小文字を置換後の文字列に当てはめます（たとえば `figure` を `image` に置換すると、`Figure` も `Image` になります）

⌘A は、スクロールして見えなくなっている行も含め、ファイル全体を選択します。そのため、続けてコピーや削除をすると、すべてが対象になります。

## コードの折りたたみ

ガターの矢印をクリックして折りたたみます。

- LaTeX では、`\begin…\end` の環境が 1 つのブロックとして折りたたまれ（入れ子にも対応）、セクションは、同じレベルか上位のレベルの次のセクションまで折りたたまれます。
- Typst では、見出しは、同じレベルか上位のレベルの次の見出しまで折りたたまれます。`{…}` のコードブロック、`[…]` のコンテンツブロック、引数リスト、数式、raw ブロック、ブロックコメントも折りたたまれます。

ある章を折りたたんだまま、後ろの章を編集できます。

## 行をコメントアウトする

⌘/ を押すと、現在の行または選択した行をコメントアウトまたはコメント解除します。LaTeX の行には `%`、Typst の行には `//` が付きます。エディタの外では、同じキーでショートカット一覧が開きます。

## マルチカーソルと矩形選択

エディタは複数の選択範囲に対応しています。 **Alt+ドラッグ**で矩形（列）選択ができ、検索ウィジェットの**一致箇所をすべて選択**で、一致ごとにカーソルが 1 つずつ置かれます。すべてのカーソルで、入力、削除、貼り付けが同時に行われます。

## インデントと括弧

エディタは入力に合わせてインデントし、1 レベルにつきスペース 4 つです。 **設定 → 外観 → エディタ**の**タブ幅**で変更できます。Tab でインデントします。オートコンプリートの候補が開いているときは、その候補を確定します。括弧と引用符は自動で閉じられ、バックスペースを押すとペアがまとめて削除され、カーソル位置の対応する括弧が強調表示されます。

## Typst の入力補助

Typst ファイルには、専用の補助機能がいくつかあります。

- `$` を入力すると、閉じる `$` も一緒に入ります。空のペアの中で Space を押すと、ディスプレイ数式の `$ … $` に変わります。空のペアの中で Backspace を押すと、両方の記号が削除されます。
- テキストを選択して `*`、`_`、`` ` ``、`$` を入力すると、太字、強調、raw テキスト、数式として囲まれます。
- リスト項目で Enter を押すと、同じマーカー（`-`、`+`、`/`、または数字）で次の項目が始まります。Shift+Enter は項目の中で改行し、空のマーカーの直後で Backspace を押すとマーカーが削除されます。Tab は項目を 1 つ深くネストし、Shift+Tab は 1 つ戻します。
- 行頭またはスペースの後で `/` を入力すると、Typst のスニペットが開きます。見出し、画像付きの図、表付きの図、表、ディスプレイ数式、ラベル付きの番号付き数式、脚注、引用ブロック、コードブロック、目次、参考文献、改ページ、段組み、グリッド、リンク、そして 3 種類のリストです。
- ⇧⌥F（Shift+Alt+F）で、typstyle を使ってファイルを整形します。⌘S を押すたびに整形するには、**設定 → 外観 → エディタ**の **Typst** にある**保存時に整形**をオンにします。自動保存では再整形されません。

`$` の対応付けには**括弧の自動補完**と**数式の自動補完**の両方が必要で、選択範囲を囲む操作には**括弧の自動補完**が必要です。どちらのスイッチも**設定 → 外観 → エディタ**にあります。リストのキーは常にオンです。補完、名前の変更、定義へ移動、シグネチャヘルプは、Typst の言語サーバーによるものです。[オートコンプリート](/docs/autocomplete/)と[コードインテリジェンス](/docs/code-intelligence/)を参照してください。

## Typst で図、表、参照を挿入する

Typst には LaTeX と同じ挿入ツールがあり、それぞれ Typst のコードを書き込みます。Typst のツールバーと、エディタの右クリックメニューにあります。

- **図を挿入**は図のダイアログを開きます。プロジェクト内の画像を選ぶか、画像を読み込み、幅、キャプション、ラベル、代替テキスト、配置を設定します。カーソルが既存の `#figure` の中にあると、同じボタンが**図を編集**を開き、それらをすべて変更できます。
- 画像ファイルをエディタに貼り付けるか、ドロップします。Oleafly は、プロジェクトに `figures/` フォルダがあればそこに、なければメインドキュメントの隣に保存し、その画像を使う図を挿入します。
- **表を挿入**は、選んだサイズの空の表を追加します。右クリックメニューの **CSV / XLSX から表を作成…** は、CSV、TSV、Excel、JSON のファイルを読み込み、キャプションとラベルは任意で付けられます。**データファイルとのリンクを保つ**をオンにすると、Oleafly はデータをプロジェクトの `data` フォルダにコピーします。表はコンパイルのたびにそのファイルを読み込むので、データを編集すると表も追従します。
- **プロジェクトから引用**は、プロジェクトの参考文献にある項目の `@key` を書き込みます。文書にまだ `#bibliography` がない場合は、Oleafly が追加します。
- **ラベルを追加**は、カーソル位置の見出し、図、数式にラベルを付けるか、すでに付いているラベルを選択します。**相互参照を挿入**は、プロジェクトのラベルを一覧し、`@label` を書き込みます。
- 数式のボタンは、行内数式、ディスプレイ数式、ラベル付きの番号付き数式、揃えた数式を挿入します。文書に数式の番号付けのルールがない場合は、注意書きに**ルールを追加**が表示されます。
- **記号**は、各記号を Typst での名前で挿入します。

[Typst で書く](/docs/writing/typst/)で、ツールバーの各ボタンを説明しています。

## ビジュアル編集

LaTeX、Typst、Markdown のどのファイルにも、ツールバーの先頭に**コード / ビジュアル**スイッチがあります。新しいプロジェクトはコードで開き、各プロジェクトは最後に使っていたモードを記憶します。Markdown には**両方**もあり、ソースと整形後のテキストを上下または左右に並べて表示します。

LaTeX と Typst では、ビジュアルモードは、マークアップをその場で描画した同じエディタです。見出し、数式、コマンドの中にカーソルを置くと、その行のソースが元に戻って表示されます。カーソルを離れると、描画された形に戻ります。ファイルは引き続きひとつだけなので、行番号、折りたたみ、検索と置換、スペルチェック、コンパイルエラーはそのまま使えます。ツールバーのどのボタンも、コードモードと同じソースを書き込みます。

Typst ファイルでは、ビジュアルモードに次のものが表示されます。

- 見出し、太字と強調のテキスト、raw テキスト、リンク、色付きのテキスト
- マーカー付きの箇条書き、番号付きリスト、用語リスト
- 行内数式とディスプレイ数式。Typst が描画します
- 画像と図。キャプションはプレーンテキストです
- 入力できるグリッドとしての表。セルを選ぶと、罫線、配置、行や列の追加と削除、表の削除のためのツールバーが現れます
- チップとしての参照と引用、小さなマーカーとしての脚注

Typst ファイルの先頭にある `#set`、`#show`、`#import`、`#let` の行は、 **文書の設定を表示**バーにまとめられます。クリックすると、その場で開きます。LaTeX のプリアンブルも同じようにまとめられます。

ビジュアルモードは、文章を見直す作業に向いています。構造やカスタムコマンドを扱うときは、コードに切り替えてください。ビジュアルモードで描画できないものは、編集可能なソースのまま画面に残ります。

## 数式のプレビュー

カーソルが数式の中にあると、描画結果がそのすぐ上に表示されます。LaTeX の数式は KaTeX が、Typst の数式は Typst が描画します。プレビューのメニューから、数式を離れるまで非表示にしたり、オフにしたりできます。 **設定 → 外観 → エディタ**の**数式のプレビュー**で、再びオンにできます。

`$\frac{a}{b}$` や `equation` 環境のような LaTeX の数式を Typst ファイルに貼り付けると、その下に **Typst の数式として貼り付け**ボタンが表示されます。クリックすると、貼り付けた内容が Typst の数式に置き換わります。LaTeX のままにするには Esc を押します。すでにファイルにある数式は、選択して右クリックメニューから **LaTeX の数式を Typst に変換**を選びます。

## ソース内のコンパイルエラー

コンパイルに失敗すると、各エラーは、それが属するファイルの中で下線が引かれます。Typst では、下線は Typst が報告した範囲そのままに引かれ、パッケージの内部で発生したエラーは、そのパッケージを呼び出したあなたのファイルの行を指します。下線にマウスを重ねると、メッセージが読めます。未知の名前、見つからないファイルやパッケージ、閉じられていない括弧など、よくある Typst のエラーには、何が起きたか、何を確認すべきかを分かりやすく説明した文が付きます。

[ログパネル](/docs/compiling/#reading-the-logs)には、すべてのエラーが、ソースの行と Typst のヒントとともに一覧されます。

## 組み込みの LaTeX リンター

エディタは、入力中に、コンパイルする前から、LaTeX ファイルの構造上の問題をチェックします。

- 対応する `\begin` のない `\end{itemize}`、または対応が合わないペア（`expected \end{figure}, got \end{table}`）
- 閉じられていない環境
- 重複した `\label{}` のキー
- 1 行に `$` が奇数個ある（ほぼ確実に、数式の区切りの書き忘れです）

エラーには赤い波線、警告には琥珀色の波線が付き、ガターにマーカーも表示されます。リンターが読むのは LaTeX だけなので、Typst や Markdown のコンパイルが止められることはありません。実際の LaTeX の実行で出たコンパイルエラーは、[ログパネル](/docs/compiling/#reading-the-logs)に別に表示され、[プリフライト](/docs/preflight/)は、ソースレベルの独自のチェックをインラインで追加します。

## 文字数と単語数

⌘K パレットから**文字数と単語数**を実行すると、アクティブなファイルの単語数、文字数、行数が分かります。Typst ファイルは Typst のルールで数えるため、コードとコメントは合計に含まれません。

## Vim と Emacs のキー

**設定 → 外観 → エディタ**の**キーバインド**で **Vim** または **Emacs** を選ぶか、⌘K パレットから **Vim モードを有効にする**を実行します。Vim では、`hjkl`、オペレーターとテキストオブジェクト（`dd`、`ciw`）、`:w`、ビジュアルモードが使えます。変更はすぐに反映され、このページにある Oleafly のショートカットも並行して使えます。

## .tex 以外のファイル

ファイルは、拡張子に合ったハイライトで開きます。BibTeX、Markdown、JSON、YAML、TOML、CSS、シェルスクリプトなどです。画像と PDF はテキストではなく描画されたビューで開き、バイナリ形式は誤って壊さないよう保護されています。[ファイルとフォルダ](/docs/files/#how-different-file-types-open)を参照してください。

未保存の編集があるファイルがディスク上で変更されると、バナーにそのファイル名が表示され、 **比較** / **自分の版を残す** / **再読み込み** が選べます。LaTeX、Typst、Markdown のどのファイルでも同様です。

## 関連ページ

- [オートコンプリートとスラッシュコマンド](/docs/autocomplete/)：コマンド、参照、引用の補完と、`/` の挿入メニュー
- [コードインテリジェンス](/docs/code-intelligence/)：定義へのジャンプ、名前の変更、ホバーカード、数式のプレビュー
- [スペルと文法](/docs/spellcheck-grammar/)：LaTeX を理解する、オフラインの Hunspell と Harper によるチェック
- [パッケージ](/docs/packages/)、[文書の分析](/docs/document-insights/)、[文書の設定](/docs/document-settings/)：ツールバー右側の文書ツール
- [キーボードショートカット](/docs/keyboard-shortcuts/)：完全なリファレンス
- [インライン AI 編集](/docs/ai-inline-edit/)：選択範囲で ⌘L を押して、変更内容を伝える
