ホーム › ヘルプ

ヘルプと機能

LightNote のすべての機能を解説した完全なドキュメント — アプリで F1 キーを押すと開くのと同じヘルプです。下の目次から各機能に移動できます。

✍️ コードエディター 🧠 ノートと第二の脳 🤖 バイブコーディング（AI + MCP）

LightNote ヘルプ

Windows 向けの軽量なコード・ノートエディター。サイドバーにセクションの一覧が並び、いま読んでいる箇所に追従します。 ウィンドウ上部の ホーム と 戻る ボタンで先頭に戻り、検索 欄でこのヘルプ内のテキストを検索できます（Enter で次へ、F3 / Shift+F3 で移動）。 いつでも F1 を押すと、現在の画面に対応するセクションでこのヘルプが開きます。

目次

編集

ツール

自動化（AI / スクリプト）

リファレンス

概要

LightNote はフォルダーをワークスペースとして開き、左にファイルツリー、 右に編集タブ、下部にステータスバーを表示します。サイドバー上部の細いストリップで、 エクスプローラー（ツリー）、検索、バージョン管理（Git）、 ファイルの履歴、未対応項目（TODO/FIXME とノートのタスク）の各セクションを 切り替えます。

コードやノートだけでなく、さまざまな形式を適切な場所で開いて編集できます: テーブル（DuckDB 経由の Parquet/CSV/JSON と Excel .xlsx）、PDF、画像 （アニメーション GIF を含む）、フォルダーとしての .zip、ブロック ノートブック（.lnb）、タスクボード（.lnt）、 カスタムテーブル（.lnd）、データベース接続 （.lnc）、SSH 接続（.lns）。統合ターミナル、 グローバル検索（ripgrep）、簡素化された Git バージョン管理、AI CLI 連携、 MCP サーバー、自動化のためのコマンドライン（lnote）も 備えています。

はじめてですか？紹介用の資料（ようこそワークスペース）は、ヘルプ → ようこそツアーを再表示からいつでも開けます。

ワークスペースとウィンドウ

ルートフォルダーとウィンドウ

開いたルートフォルダーがワークスペースです。開くだけでは何も作成されません。 閉じるとき、LightNote は小さなセッションファイル（開いていたタブと位置）を書き込むだけです。 ワークスペースが独自の永続的な設定を持つ「プロジェクト」になるのは、 ツール → ワークスペースの設定でバージョン管理（Git）または MCP を 有効にしたときだけです。

全般設定はアプリケーション全体に適用され、ワークスペースの設定は 開いているフォルダーにのみ適用されます。設定と状態は、フォルダー内に散らばらず、 中央のデータベースに保存されます。

LightNote は単一インスタンスで動作します。2 つ目のフォルダーを開くと プロセスを再利用します（マルチウィンドウ、省メモリ）。ワークスペースを一覧表示する 検索ボックス付きのランチャーとトレイアイコンがあります （コンテキストメニューでお気に入りを上部にピン留め）。 デイリーノートとトレイを参照してください。各タブには、 タブバーのコンテキストメニューからカラーラベルを付けられます。 繰り返し使うノートには、.md ファイルを入れた Modelos （または Templates）フォルダーをワークスペースのルートに作成し、 ファイル → テンプレートから新しいノート…を使ってください。 学術向けのテンプレートが四つ、同じ一覧に用意されています —— 学術論文、読書ノート、実験ノート、実験計画。選ぶとその .md がこのフォルダーに書き込まれ、以後は自由に編集できます。

テンプレートの整理と作成。 Templates のサブフォルダーはカテゴリーになります。仕事/会議.md は 仕事/会議 と表示され、フォルダーがそのテンプレートを採用するときに記録する名前もこれです。{{title}}、{{date}}、{{time}}、{{date:dd/MM/yyyy}} の各フィールドは作成時に埋められます——タイトルはノートの名前で、作成直後に何も書く前に名前を変えるとタイトルも作り直されます——そしてコードの中（バッククォートの間やブロックの中）では何も置き換えられないので、テンプレートが自分自身の書き方を説明できます。テンプレートの中では、これらも埋めるためのフィールドと同じ背景で示され（書式付きエディターでは構文を表す実線の枠付き）、普通のノートでは色が付きません。そこでは何も起きないからです。テンプレートの frontmatter はノートに引き継がれますが、テンプレート自体を説明する description: と、フォルダーに属する citation-style: は除かれます。テンプレートとプロンプト（Prompts/ フォルダー）はコンテンツではなくツールです。意味による検索や AI チャットのコンテキストには含まれず、そこで宣言されたタグや aliases: も数えられません——テキスト検索では引き続きどちらも見つかります。テンプレートを開くと、エディターの上部の帯がそれがテンプレートであることを示し、フィールドを挿入、構文を表示、プレビュー（今作られるノートの姿）を出します。テンプレートライブラリ（ツールにあり、ファイル → テンプレートから新しいノート…が開くものと同じ）は、名前と説明での検索、サブフォルダーごとのグループ分け、プレビューを備えてすべてを一覧します。新しいテンプレートもここで作れます——開いているノートからも作れ、その場合はタイトルと今日の日付がフィールドになります。 ライブラリには サイトから というグループもあります。私たちが公開しているテンプレートで、インターフェースの言語のものが、ライブラリを開いたときだけ取得されます。取り込みは コピー です——テンプレートは Templates にあるあなたのファイルになり、その後は両者を結ぶものは何もありません。サイトで直したテンプレートが、すでに取り込んだものを追いかけることはなく、同じ名前のあなたのテンプレートが常に優先されます。接続がないときは、取得できなかったと伝えたうえで、このパソコンにすでにあるものを表示し続けます。

埋めるためのフィールド。 テンプレートには空欄を残せます。{{ask:会議の議題}} は自由入力のフィールド、{{choice:下書き|レビュー|確定}} は一覧です。作成時に置き換えられることはありません——ノートはそれらが本文に印として入ったまま生まれ、だからこそ 今日のノート や lnote、MCP でも同じように働きます。そこには尋ねる画面がないからです。ノートでは、書式付きエディターは各フィールドを、ラベル（質問、または最初の選択肢）を破線の枠で囲んだタグとして表示します。クリックするとフィールド全体が選択され、次に打ったキーがそれを置き換えます。選択のフィールドではクリックで一覧も開きます。選ぶとフィールドがその語に変わり、選ばずに閉じればフィールドは選択されたままなので、別の言葉を打てます。ノートを作ると、カーソルは最初のフィールドに置かれます。そこから Tab と Shift+Tab でフィールドからフィールドへ移動でき（いまどのフィールドにいるかはステータスバーに出ます）、Alt+↓ でキーボードから選択の一覧を開けます。Esc（またはフィールドの行を離れること）で Tab はいつもの働きに戻ります。テンプレート自体では 構文を表示 がオンになっていて、フィールドは実線の枠の {{…}} として表示され、クリックするとカーソルがその中に入るので、質問や選択肢を直せます。オフにすると、テンプレートはそこから作成されるノートと同じ見た目になります。6 つのフィールドは / メニューと 挿入 → テンプレートのフィールド にもあります（テンプレートファイルでだけ）。テキストエディターでは、フィールドはファイルにあるとおりに色付きの波かっこで表示され、スペルチェックは入りません。

ファイルを作る

種類を選んでファイルを作る。 新規メニュー（☰ ファイル、アクティビティバーの新規ボタン、フォルダーのコンテキストメニューの新規作成）には、新しいノート (.md)、新しいテキストファイル (.txt)、よく使う言語をそろえた新しいコードファイルのサブメニューがあります。いずれもファイルは既定の名前ですぐにディスク上に作成され、ツリーで名前の編集が開きます。選択されるのは名前の部分だけなので、タイトルを入力しても拡張子は消えません。提案された名前でよければ、エディターをクリックして書き始めるだけです。サブメニューにない拡張子は、ファイルを作成して名前を変更してください（F2）。拡張子を変えると表示も変わります。.txt を .md に変更すると同じタブがノートとして開き直され、読書ビューと目次が付きます。逆にすればコードエディターに戻ります。LightNote 固有の拡張子（.lnc、.lne、.lnq、.lnh、.lns とバンドル）は例外です。そこでは拡張子が内容の形式を宣言するため、名前の変更には確認が入り、タブが開いている間は拒否されます。

使わずに終わった新規ファイル。作成したばかりのファイルのタブを、名前を付けず、保存せず、何も入力しないまま閉じると、そのファイルはごみ箱に移動し、ステータスバーに元に戻すが表示されます。うっかり新規を押しても、フォルダーに残骸が残りません。名前の変更、保存（Ctrl+S）、何かを入力する — どれか一つでも行えば、そのファイルは通常のファイルとして残ります。

下書きは Markdown エディタです。 下書きタブ（ディスク上のファイルではありません）は、ノートと同じテキストエディタを使います：記法のハイライト、スペルチェック、[[ の補完、ウィキリンクとタグの Ctrl+クリック。ないものはこれまでどおりです——ファイルがないので自動保存も表示モードもありません。内容はアプリを閉じても残り、タブを閉じると消えます。

新しいファイルが作成される場所。新規は常にエクスプローラーでマークされたフォルダーに作成し、マークされたフォルダーは常にちょうど 1 つあります。ツリーの一番上にはルートフォルダーの行（ワークスペース名）があります。これは他と同じ項目で、クリックすると作成先がルートに戻ります。フォルダーを選択するとマークがそこへ移り、ファイルを選択するとそれを含むフォルダーがマークされます。フォルダーを表示しないリストモードでは、マークはルート行に残り、その行が実際の作成先を表示します。ルート行のコンテキストメニューには新規作成とフォルダーを作成があります。

単体ファイルとお気に入り

ワークスペースにせずに単体のファイルを開くには、単体ファイルを開く… （トレイメニュー）を使います。単独ウィンドウはファイルツリーを表示しますが、 Git・MCP・テーマの上書きはありません。設定 → 一般 → 機能で 有効にすると、LightNote は Windows エクスプローラーのメニューに統合されます （ユーザーごと、管理者権限不要）。「プログラムから開く」一覧に加えて、 コンテキストメニューに任意のファイルで「LightNote で開く」、フォルダーで 「LightNote のワークスペースとして開く」が追加されます（Windows 11 では その他のオプションを表示の中）。ファイルはその単独ウィンドウで、 フォルダーはワークスペースとして開きます。

Windows エクスプローラーで複数のファイルを一度に選ぶと、別々の フォルダーのファイルであっても、すべてが同じ単独ウィンドウにタブとして 並んで開きます（ファイルごとにウィンドウが増えることはありません）。このウィンドウの タブは記憶されます。閉じてもう一度開けば、同じファイルが戻ります。ここでは タブが主役なので、ファイルツリーは折りたたまれた状態で開きます。Ctrl+B （またはアクティビティバー上部のボタン）で表示できます。

セッションに戻る。単独ファイルのウィンドウは、どこでも単独ファイルという名前で表示されます。他のウィンドウがワークスペース名を表示するタイトルバーにもこの名前が出るので、Alt+Tab で見分けられます。通知領域メニューの開くでは、保存されたタブがあるときに（タブ N 個）が付き、クリックするとすべて戻ります。ランチャーの先頭行にも、ワークスペースと並んで表示されます。さらに LightNote を開き直すと、終了時に開いていたすべてが戻ります— 各ウィンドウはそれぞれのフォルダーで、単独ウィンドウも一緒に。最後に使ったフォルダーだけを開きたい場合は、設定 → 一般 → インターフェイス → 起動時に開くで変更してください。終了前に閉じたウィンドウは対象外です。閉じることが「この空間はもう終わり」という合図だからです。

お気に入り: サイドバーには お気に入り セクションがあり、ピン留めした もの（ツリーまたはタブの右クリックメニュー → お気に入りに追加）と最近開いた ファイルが表示されます。ピン留めはフォルダーごとで、相対パスとして保存されるため、 ワークスペースを移動しても残ります。

タブを独立したウィンドウで開く: タブの右クリックメニューの 新しいウィンドウで開く は、そのファイルを単独ウィンドウで開き直します （コードの横にノートを並べるのに便利）。ワークスペースに依存する種類 （.lnc、.lne、.lns やバンドル）は切り離せません。

エクスプローラー

タブを開いたままファイルを移動する。ツリーでファイルを別のフォルダーへドラッグすると、タブも一緒に移動します——開いたままで、新しい場所を指します。切り取りと貼り付けも、フォルダーごとの移動（中のファイルのタブも付いていきます）も同じです。Ctrl を押しながらだと、移動ではなくコピーになります。LightNote の外へのドラッグは常にコピーです。ツリーからファイルを、あるいはタブそのものをタブバーから Windows のフォルダーやメール、Teams の会話に放しても、元のファイルはワークスペースに残ります。アプリ内ではタブはあくまでタブです。別のペインへドラッグすればタブが移動し、エディタやツリーの上を通っても何も書かれず、何も移動しません。

複数選択。 ツリーは 3 つの表示モードすべてで Ctrl+クリック（個別）と Shift+クリック（範囲）を受け付けます。複数の項目を選択すると、コンテキストメニューは選択全体に対して働きます：切り取りとコピー（Windows エクスプローラーと相互運用）、削除（確認は全体で 1 回）、複製、ハッシュをコピー、.zip に圧縮（1 つの書庫にまとめ、各項目は自分の名前で最上位に入ります）、色を付ける、お気に入り、Git（add/restore）、パスのコピー（1 項目 1 行）。1 項目にしか意味のない操作（その場での名前変更、プロパティ、指定して開く、変換）は無効になり、理由がツールチップに出ます。選択範囲の内側で右クリックすると選択は保たれ、外側をクリックするとその項目だけが選ばれます。フォルダーとその中身を同時に選んでも操作は二重に走りません：内側の項目は除外されます。

開かずに覗く。 ファイルをシングルクリックすると、すでにプレビュータブが開きます（使い回され、タブバーでは斜体）。矢印キーでツリーをたどっているときは Space キーが同じことをし、フォーカスをツリーに戻すので、そのまま一覧を下りていけます。

ファイルツール。 エクスプローラーのコンテキストメニューに ファイルツール サブメニューがあります: 一括リネーム（拡張子/ワイルドカード/正規表現でフィルター＋プレビューと衝突検出付きの規則パイプライン）、ファイルを分割（行数・サイズ・正規表現の区切り）、ファイルを結合（任意でCSVの最初のヘッダーのみ保持）、複製、ハッシュをコピー（MD5/SHA-256）、.zip に圧縮 / ここに展開。 複数の項目を選んでいる場合、一括リネームとファイルの結合には選んだ項目がそのまま渡されます（フォルダー全体を走査しません）。結合は選択した順序を守ります。

単独ウィンドウの移動。 ツリーの上に戻る（Alt+←）、進む（Alt+→）、上へのボタンと、クリックできるフォルダーの道筋があります（各区切りでその階層へ移動）。マウスのサイドボタンでも戻る・進むができます。パスを入力するには帯の空白部分をクリックするか Ctrl+L を押します。Esc で取り消して道筋に戻ります。タブを切り替えると表示中のフォルダーも移動します。単体ウィンドウは異なるフォルダーのタブをまとめるため、タブをクリックするとそのフォルダーへ移動します。

メニューとズーム

メニュー。 アクティビティバー上部の ☰ ボタンに ファイル・編集・表示・ウィンドウ・ツール・AI・ヘルプ の各メニューがまとまっています。AI の操作は専用メニューにあります（アクティビティバーの杖ボタンからも開けます）。ツール ではサブメニューにグループ化されています: 実行（F5/F6/F8、lint、ターミナルへ送信、マクロ）、キャプチャ（今日のノート、クイックキャプチャ、クイックタスク、音声録音、付箋）、ワークスペース（設定、スナップショット、コピーのエクスポート、フォルダーの移動）。最後のものは歯車メニューからも開けます。新規 メニューは、☰ ファイル、新規 ボタン、フォルダーの右クリックメニューの 新規作成 の 3 か所で同じ内容です。

ズームはどのビューでも同じ場所。ズーム倍率はステータスバー右側の − 100% + のグループ一か所にまとまっています。中央のボタンで標準の一覧が開きます — 幅に合わせるとウィンドウに合わせる（PDF や画像のように内容自体に大きさがある場合のみ）、200%・150%・120%・100%・75%・50% の各倍率、そしてカスタム…。有効な項目にはチェックが付きます。ズームのあるビュー（コード、ノート、PDF、画像、HTML、表計算）ではショートカットも共通で、Ctrl++、Ctrl+−、100% に戻す Ctrl+0、Ctrl+マウスホイールが使えます。ズームのないビューではグループ自体が表示されません。合わせるモードのときは、パーセントの代わりに幅またはウィンドウと表示されます。 ズームはタブのもので、ファイルのものではありません。長く使わずメモリを解放されたタブや、LightNote を開き直したときに戻ってくるタブは、そのときの倍率のまま復帰します。ファイルを新しく開き直した場合は 100% から始まります。

コードエディター

開く・強調表示・整形

テキスト/コードファイルは、構文ハイライト付きのエディター（Scintilla）で開きます。 コメントの切り替え（Ctrl+/）、行の移動と複製、ブックマーク（Ctrl+F2）、 シンボル/関数の一覧、単語ベースの自動補完、インデントガイド、折り返し、ズーム、 ディスク上のファイル変更の検出があります。バージョン管理を有効にすると、 余白に最後のバージョン以降に追加/変更された行が示されます。

マクロ（一連の編集を記録/再生。Ctrl+Shift+R / F4、 ツール → マクロ）、整形（beautify）（Shift+Alt+F）、 文字や罫線を挿入するためのタブツールバーの ASCII 表、スペルチェッカー （Hunspell）もあります。pt-BR と en-US は内蔵されており、その他の言語は 設定 → ノートと執筆 → スペルの表から必要に応じてダウンロードできます （言語ごとに1行、ダウンロード/削除ボタン付き）。 書き込まれているログファイルを追跡するには、タブ専用ツールバーの 監視（tail -f）ボタンを使ってください。非常に大きいファイル（約 1 MB 超）は、 表示中のチャンクだけを読み込む仮想化された軽量エディターで開きます。 ファイル → 軽量エディターで開く…から手動で強制することもできます。

整形とチェック（リンター）: Shift+Alt+F は、インストールされていれば その言語の外部フォーマッター（black、prettier、clang-format、gofmt、rustfmt など） で文書を整形し、オフラインでは内部フォーマッター（JSON/XML）にフォールバックします。 F7 はその言語のリンター（ruff、eslint、shellcheck、luacheck など）を実行し、 問題をエディターと問題パネル（下部ペイン、移動可能）に下線で表示します。両方とも 設定 → 整形と→ リンターに追加のあるカタログがあり、保存時に整形 / 保存時にチェックのオプションもあります。ファイルを出力パネルで実行するには F6（終了コードと所要時間を取得、停止/再実行あり）、一部だけなら F8 を使います。

コードとして開いた .md は、ワンクリックでノートに戻せます。 開いているファイルがノートのとき、エディターのバーに ノートとして開く が表示されます。ツリーメニューの次で開く → コードの逆で、タブを書式付き編集・読書・アウトライン・プロパティのあるノート表示に戻します。切り替えが可能なときだけ表示されます。大きすぎるノートはコードエディターのままです。

マルチカーソル・履歴・定義

その他の編集機能: 出現箇所ごとのマルチカーソル（Ctrl+D、すべては Alt+F3）、行の複製（Ctrl+Shift+D）、行の結合（Ctrl+Shift+J）、 スコープ単位で選択を拡大/縮小（Ctrl+Shift+Space / Ctrl+Alt+Space）、 矩形選択（Alt+ドラッグ）、すべて折りたたみ/展開、スニペット（Ctrl+J、 設定 → エディターで編集可）、ファイル内のシンボルへ移動（パレットの #）とプロジェクト内（Ctrl+T または ##）、 ナビゲーション履歴（Alt+←/→）、エディター上部のパンくずリスト、列の ルーラー、括弧ペアの色分け、ペアの自動閉じ/囲み、保存時のクリーンアップ （末尾スペースの除去、末尾改行）— すべて設定 → エディターにあります。

ローカル履歴とクリップボード: 保存のたびに、LightNote は Git とは独立して ファイルのバージョンを保持します（ファイル → ローカル履歴…、復元可能）。 Ctrl+Alt+V はクリップボード履歴を開き、以前コピーした項目を貼り付けます。 Ctrl+Shift+T は最後に閉じたタブを開き直します。タブはピン留めでき （コンテキストメニュー）、非アクティブ時の解放から保護されます。

定義へ移動： 識別子の上で F12 または Ctrl+クリックすると、プロジェクト内で定義されている場所へジャンプします。Shift+F12 は使用箇所を探します。

ミニマップとテキスト操作

ミニマップ。 エディタの右端に文書全体のミニチュアが表示されます。コードの「形」（構文強調の色を縮小したもの）を示し、表示中の範囲をマークします。クリックまたはドラッグすると、ファイルの任意の位置へ移動できます。表示 → ミニマップ または 設定 → エディタ で切り替えます。 コードタブ自身のツールバーにあるミニマップボタン（ASCII の隣）でも、エディタを離れずに切り替えられます。ミニチュアの左端にはマーク帯があります。青はブックマークのある行（余白の丸印と同じもの）、アンバーはクイック検索の該当箇所です。画面外の部分も含め、ファイル全体でどのように分布しているかが一目で分かります。

テキスト操作。 編集 メニュー（およびエディターの右クリックメニュー）に 行（移動・複製・削除・並べ替え・結合・反転・番号付け）と クリーンアップ（空白の除去、空行・重複行の削除、タブ ↔ スペース）のサブメニューがあります。選択があるときは右クリックメニューに 選択範囲を新しいファイルに保存… も表示され、選択部分を現在のファイルの隣に書き出してタブで開きます（元のファイルは変更されません）。

Markdown とウィキリンク

表示モード

.md ノートは、エディターと読書を並べて開きます（構成可能）。 カーソルのある段落の外では記法が淡色表示になり、ページが完成した文書のように見えます。

ショートカット: Ctrl+B/Ctrl+I で太字/斜体、Ctrl+E で表示モード（編集 → 分割 → 書式付き → 閲覧）を切り替えます。

/ メニュー: 書式付きエディターで、行頭（インデントがあっても構いません）またはスペースの後に / を入力すると、挿入リストがカーソル位置に開きます。入力して絞り込み（/テーブル、/コールアウト、/h1）、↑/↓ で選び、Enter で挿入します。Esc または スペース で閉じると、入力した文字はそのままテキストとして残ります。右の列には、その項目が書き込む記法が表示されます — 次回からは直接入力できます。コードブロック、数式、表のセルの中ではメニューは開きません。

読み取りモード： Ctrl+E の最後のモードは書式付き編集と同じ画面ですが、読み取り専用です。だからこそ、ファイルにないものを表示できます — [TOC] トークンの目次です。[files] トークンのフォルダー一覧と ![[ノート]] で取り込んだノートの本文は、書式付き編集にも出ます。いずれも .md には書き込まれません。ファイルにはトークンが残り、生成された文字列は編集できません。このモードではシングルクリックでリンク・ウィキリンク・タグをたどれ（Ctrl は不要）、編集のボタンは無効になります。元に戻す・切り取り・貼り付け も含まれます（以前は画面外のテキストエディターに作用していました）。コピー はそのまま使え、画面に見えているものをコピーします。 Ctrl+F は画面に出ているものを検索します。置換の行は無効で、理由はツールチップに出ます。ここで置換してもファイルには届かないからです。

読み取りモードでの、単位付きの計算。= で終わる行が結果を受け取ります。3,5 km / 2 s = は 3,5 km / 2 s = 1,75 km/s と表示されます。ファイルは変わりません — [TOC] や整形された引用と同じ考え方です。次元解析をするので、1 km + 1 s = は両方の名前を挙げて断られます。そこで 2 を返す計算機は、劣っているのではなく、嘘をつくものだからです。実験ノートでは、その誤りが論文まで生き延びます。同じ量を別の単位で足すのはできて、換算もされます（2 h + 30 min =）。結果はあなたが書いた単位で出ます。SI 接頭語、物理定数（c、h、k_B、N_A、g など）、明示的な換算（3 km in m、to や -> も可）、不確かさも分かります: (2,00 ± 0,05) m / (1,0 ± 0,1) s = は誤差を伝播させ、測定が許す桁だけを書きます。コードと数式は対象外です — ``` の囲みの中、バッククォートの間、$…$ の中では、行末の = は別のものの文法です。計算でない行（合計 =）は黙ってそのまま残ります。既定でオフです。設定 → 機能 → 学術 → 単位付き計算でオンにしてください。

間隔反復のカード。 #flashcards タグを付けたノートは デッキになります。その中では、質問::解答 の各行が 1 枚のカード、 ::: は裏向きのカードも作り、2 行のあいだの ? 単独行は 複数行のカードになり、==このように== は空欄になります。タグがなければ、 どのノートにもカードはありません — プログラミングのノートにある std::vector が、書いた覚えのないカードになってしまうのを防ぐためです。 ツール → カード → カードを復習 でセッションが始まります。解答は自分で求めるまで 隠れたままです（これが機能の本体です。両方を同時に見るのは読み返しであり、読み返しでは 定着しません）。4 つの評価には、それぞれが買う時間が書かれています。予定を組むのは FSRS、Anki と同じアルゴリズムです。カードの同一性は「質問」です。 解答を直しても予定は変わらず、質問を書き直すとそのカードは引退して別のカードが始まります — 学んでいるのは質問のほうだからです。履歴はノートの隣の開かれたファイル (ノート.md.cards.ndjson) に残ります。Git で版管理でき、どのエディターでも 読めます。代償はフォルダーにファイルが 1 つ増えることです。Anki にエクスポート は Anki が読み込むテキストファイルを書き出しますが、予定は一緒に行きません。 Anki のテキスト取り込みが受け付けないからで、予定は .ndjson に残ります。

コードブロック

コードブロックに色が付きます。 言語を宣言したフェンス（```python）は、コードエディターと同じ配色でトークンごとに強調表示されます。このウィンドウ用に選んだコードテーマも反映されます。書式付き編集、読書モード、エクスポートしたファイル、ノートに質問の回答で有効です。言語を宣言していないフェンスは単色のままで、強調表示に対応しない言語も同様です。テキストが表示されなくなることはありません。

折りたたみ・固定・書き出し

セクションの折りたたみと見出しの固定は、書式付き編集と読書モードでも使えます。 Ctrl+Shift+[ でカーソルのセクションを折りたたみ、Ctrl+Shift+] で展開します。見出し左の小さな矢印をクリックしても同じで、表示 → すべての見出しを折りたたむ／展開する は前面にある画面に作用します。スクロールすると、上に流れた見出しが上部の帯に固定されます。クリックするとそのセクションへ移動します。折りたたみは画面の状態です。.md は変わらず、折りたたんだ文章はファイルに残ります。

エクスポート： PDF と HTML は読み取りモードと同じドキュメントから生成されます。得られるファイルは、いま読んでいたものそのままで、目次・フォルダー一覧・取り込んだノートも含まれます。HTML は自己完結（ローカル画像は埋め込み）で、PDF はベクターテキストなので検索できます。HTML は意味づけされたマークアップで出ます —— 見出しにはアンカー、コールアウトは <aside>、表には見出し行、脚注には戻りリンク —— そして数式は MathML です。本物のテキストなのでコピーでき、読み上げられ、拡大してもぼやけません。 テーマは形式ごとに変わります。HTML は画面で見ている色をそのまま保ち、ダークテーマも含まれます（ファイル自体が背景を持つため）。PDF は常に明るい紙になります。印刷して送るためのものだからです — 内容テーマがダークの場合は既定の明るいテーマで印刷され、すでに使っている明るいテーマはそのまま保たれます。 Word・OpenDocument・LaTeX・Typst・EPUB は LightNote 自身が書き出すので、何もインストールする必要はありません。.docx と .odt には見出し・リスト・表・脚注・画像が入り、数式は編集できる数式になります（Word では Word の数式、LibreOffice では Math のオブジェクト）。.tex は完全なプリアンブル付きで、pdfLaTeX・XeLaTeX・LuaLaTeX でコンパイルできます。フォルダーに書誌があり、学術セクションが有効なら、.tex は生きた引用で出ます。[@キー] は \autocite に、[bibliography] トークンは \printbibliography になり、引用した文献だけの refs.bib が隣に保存されます（保存したことはアプリが伝えます）。biber でコンパイルしてください。.typ は同じことを Typst で行うもので、LaTeX ディストリビューションなしに数秒でコンパイルできます。数式は mitex パッケージ（初回コンパイル時にダウンロード）で LaTeX のまま運ばれ、引用は @キー と #bibliography で出ます。.epub は電子書籍です。レベル 1 の見出しごとに 1 章、ナビゲーション用の目次つきで、画像はパッケージ内のファイルになり、HTML と同じ意味づけされたマークアップで出ます。.ipynb は Jupyter のノートブックです。本文はテキストセルに、カーネルの言語のコードブロックはコードセルになります。そのブロックだけです —— コードセルはカーネルに送られるので、Mermaid の図をセルにしてしまうと、最初に実行した時点で Python として実行されてしまいます。カーネルはノートのプロパティの kernel キー、なければ最も多いコードブロックの言語から決まります。出力は作りません。セルは結果なしで出ます。結果は実行から生まれるものだからです —— ノートブックの取り込みが保存済みの出力を捨てるのと同じ理由です。さらにMarkdown の書き出し先があります。同じノートを相手の方言で出せます —— GitHub なら > [!NOTE] のアラート、MkDocs なら !!! note、Docusaurus なら :::note、Pandoc なら ::: {.note}、Obsidian の書き方、あるいは厳密な CommonMark。ウィキリンクは相対リンクになり（Obsidian 以外）、%%…%% のコメントは公開されません。あれは私的なものだからです。Typst を入れておくと（winget install --id Typst.Typst）、エクスポートの画面がそのままPDF をコンパイルを提案します。入っていなければボタンはTypst をインストール...になり、ガイドが開きます。大学や取引先が Word のひな形を配っている場合は、その .docx をワークスペース設定 → 引用と参考文献 → Word のひな形で指定してください。エクスポートされたファイルはひな形のスタイル・用紙・余白・ヘッダーで出ます。ノートごとにプロパティで reference-docx: hinagata.docx と書けば別のひな形も使えます。いずれも読み取りモードの Markdown から作られます —— 引用は整形済み、図には番号 ——。持ち込めなかったものはエクスポートの終わりに知らせます。Mermaid の図と化学構造は画像として入ります。.docx・.odt・EPUB では明るい用紙に、HTML では画面の配色で描かれます。描くウィンドウのない lnote から書き出したときだけ、コードブロックとして出ます。さらにマークアップの書き出し先…があります。reStructuredText、AsciiDoc、Org mode、MediaWiki、プレーンテキストも LightNote 自身が書き出します。どれもその形式のネイティブな書き方で出ます。真似ではありません。ボックスは Sphinx では .. note::、AsciiDoc では [NOTE]、Org では #+begin_note になり、数式は .. math::、latexmath:[]、素の LaTeX、<math> になり、脚注は footnote:[] や <ref> になります。プレーンテキストには記法がまったくありません —— 表は桁をそろえて出るので、メールやコミットメッセージにそのまま収まります。行き先にない機能は最後に知らせます。MediaWiki の本体には注意書きのボックスがなく（ラベルを太字にした引用になります）、reStructuredText には取り消し線がありません。ファイルを書き出さずに一部だけ持ち出すには、エディターのコンテキストメニューの選択範囲を形式を指定してコピー（選択していなければノートを形式を指定してコピー）を使います。Word、Google ドキュメント、メールに貼り付ける書式付きテキスト、GitHub の Markdown、LaTeX、Typst を選べます。LaTeX と Typst は本文のみで、プリアンブルもタイトルも含みません。貼り付け先の文書にはすでにあるからです。その部分に必要なパッケージや、貼り付け先の書誌に依存する引用はステータスバーで知らせ、%%…%% のコメントも持ち込みません。RTF はその他の形式 (pandoc)にあり、別のプログラムである pandoc を通ります（winget install --id JohnMacFarlane.Pandoc）。入っていないときはその行き先が無効になり、理由が添えられます。同じサブメニューのpandoc をインストール...がガイドを開き、インストールまで行います。すでに別の場所に pandoc がある場合は、ガイドのすでにある: ディスクから指定...か、設定 → コードツール → 外部プログラムでファイルを指定してください。

オプションを指定してエクスポート...はエクスポートメニューの最初の項目です。タブのメニューとファイル → ノートをエクスポートは同じメニューです。すべての書き出し先が一覧になり、名前・用途・拡張子で検索できます（wiki で MediaWiki、sphinx で reStructuredText が見つかります）。表示されるのは選んだ書き出し先に効くオプションだけです。ノートにまだ [TOC] がないときの先頭に目次、ハイフネーションと文書が自動で付けるラベルを決める文書の言語、LaTeX と Typst での引用（ライブか本文で解決か）、フォルダーの既定にするチェックボックス付きのWord のひな形、古い電子書籍リーダーやメールに貼る HTML 向けに HTML と EPUB の数式を MathML にするか画像にするか、PDF の用紙（A4 またはレター）、そして続けて Typst で PDF をコンパイルです。効くのに使えないオプションは理由付きで無効になり（フォルダーに参考文献がないときのライブ引用など）、足りないプログラムに頼る書き出し先はその場でインストールを勧めます。最後の選択はフォルダーごとに記憶され、ダイアログは前回のまま開きます。メニューの直接の項目は工場出荷時の値で書き出し続けるので、何週間も前の選択がショートカットで作るファイルを変えることはありません。ノートに書いた [TOC] はすべての書き出し先で有効です。Word と LibreOffice では目次（Word は開くときに更新）、LaTeX では \tableofcontents、Typst では #outline()、HTML と Markdown ではリンクの一覧になります。選択範囲を形式を指定してコピーの書式付きテキストでは、数式と図は画像として入り、代替テキストに LaTeX のソースが付きます。どこに貼り付けられるか分からず、Word・Google ドキュメント・メールで同じに見えるのは画像だけだからです。編集できる数式が必要なら .docx か .odt を書き出してください。

フォルダーごと書き出すこともできます: ファイル → フォルダーを書き出す...（またはツリーでフォルダーを右クリック）で、そのノートが HTML サイト（ノートごとに 1 ページ。どのノートも index.html になっていなければ索引ページも作られます）、.docx や .odt のセット、あるいは書き出し先の方言に合わせた Markdown のツリーになります。サブフォルダーの構成はそのまま保たれ、ノート同士のリンクとウィキリンクは書き出されたファイルを指すようになり（Word と LibreOffice でも、文書から文書へ）、フォルダーの中にある画像と添付ファイルも同じ位置に一緒に出ます。フォルダーの外にあるものはコピーされません。書いたままで残り、最後の報告が行き先のないリンクとあわせて一件ずつ挙げます。保存先のフォルダーは空でなければならず（または 同じ名前のファイルを置き換える にチェックを入れます）、書き出すフォルダーを含むことはできません。ウィンドウなしでも: lnote folder-export --path . --format html --out site、そして MCP の folder_export。そこではトランスクルージョン・[files]・図番号は解決されません。それを解決するのはウィンドウだからです。

書式付き編集

書式付き編集（WYSIWYG）: 4 つ目のモードは、記法ではなく仕上がりを表示します — 見出しは見出しの大きさ、リストは行頭記号つき、テーブルは表、画像は本文の中に。 ファイルは同じ .md のままです。書き出すのは Qt ではなく LightNote なので、 太字・斜体・ウィキリンク・トランスクルージョン・コールアウトが往復しても失われません。 モードに入って編集せずに出れば、ファイルは 1 バイトも変わりません。ツールバーは Markdown で表せるものだけを出します — 見出し、太字、斜体、取り消し線、コード、リスト（タスクの チェックボックスつき）、引用、リンク、テーブル、水平線。配置・字下げ・文字サイズは保存時に 失われるため入れていません。

テーブルの中では Tab がセルを移動し、最後のセルでは次の 行を作ります。 テーブルの右側の余白（行の右をクリックするとカーソルが落ちる場所）で Enter を 押すと、末尾に行を追加し、カーソルは最初のセルに入ります。 セルの中では Enter がその場で改行し（ファイルには <br> として入ります。Markdown のテーブルが受け付ける唯一の形です）、Ctrl+Enter は 下に行を作り、カーソルは同じ列に入ります。 テーブルにマウスを乗せると控えめなハンドルが出ます。行の左には上下に動かす 矢印の組（ドラッグして別の位置へ運ぶこともできます）、列の上には左右に動かす 組、そして下の辺と右の辺には行と列を足す + です。1 行目はヘッダーなので 動きません。どれも右クリックのテーブルにもあります。そこには、表をまるごと外す安全な道の 表を削除もあります。

ボックス（<details> や :::）では、最後の行が ボックスを閉じるもので、削除できません。下の内容がボックスに飲み込まれないように するためです。テキストを残したままボックスをやめるには、右クリックの ボックスを解除を使います。Enter は必ず行を作ります。空のリスト項目では行を増やさずにリストを 抜け（Word と同じです）、空の段落では空行を作ります。ファイル中の空行 1 つは段落の通常の 区切りで、空の行としては表示されません。2 つ目からは表示され、書いたとおりにファイルへ 戻ります。

画像の右端をドラッグすると大きさが変わり、その幅は ![alt|300](foto.png) としてファイルに入ります。バーには 12 個のコントロールがあります。太字・斜体・見出しは直接置かれ、残りは役割で二つのメニューに分かれます。書式はすでに書かれているものに作用し（記法、リスト、引用、表の配置、テキストの操作）、挿入は新しいものを作ります（リンク、画像、表、ブロック、図、数式、強調ボックス）。表の整形とテキストメニューは今もテキストエディターのもので、ここでは理由付きで無効になります。記法の淡色表示は表示ボタンへ移り、四つのモードすべてで使える読書用の列とタイプライタースクロールの隣にあります。そして挿入メニューは、テキストエディターと同じものをここでも提供します — ハイライト、上付き、下付き、ウィキリンク、脚注、強調ボックス、折りたたみブロック、目次、定義リスト —。このモードが表示はできても作成できなかったものすべてです。

読書モードが見せるものを、書式付き編集も見せるようになりました。 絵文字 :fire: は 🔥、==ハイライト== は黄色いマーク、^2^ と ~2~ は上付き・下付き、#タグ はピル、裸のウェブアドレスはリンクとして表示されます。ファイルは書かれたままの形を保ち、ノートを開いても何も書き換えません。表示された範囲の内側を編集してもマークアップは残り（ハイライトの真ん中に入力すればハイライトのままです）、その直後に入力した文字は範囲の外に出ます。コメント %%…%% は淡色で表示されたままです。隠すと見えなくなるうえに編集もできなくなるからです。

コールアウトは書式付き編集でもボックスになります。 > [!NOTE]（または [!TIP]、[!IMPORTANT]、[!WARNING]、[!CAUTION]）で始まる引用は、読書モードと同じように色付きのバーとタイトルで表示されます。マーカーは種類のラベルに置き換わり、> [!TIP] 自分のタイトル と書けばそのタイトルになります。ファイルには書いたとおりのマーカーが残り、タイトルを編集してもコールアウトの種類は保たれます。 Obsidian と MkDocs のコールアウト名も理解します。[!SUCCESS]、[!ABSTRACT]、[!FAILURE]、[!QUESTION] とその別名（tldr、missing、faq）は最も近い箱に収まるので、あちらから来たノートもそのまま色付きで表示されます。書き出すときは、それぞれの形式が知っている名前に置き換わります。

新規インストールでは、これが既定のモードです。すでに LightNote を使っていた場合は、それまでのモードが保たれます。変更するには設定 → Markdown → ノートを開いたときの既定の表示を使います。目次の見出しをクリックすると、書式付き編集や閲覧から抜け出さずに、そのモードのまま移動します。

表の列を揃える。 カーソルを表の中に置くと、コンテキストメニューに テーブル → 列の揃え が現れます（左揃え、中央揃え、右揃え、既定値）。揃えは 列全体 にかかります——Markdown がそう表現するからです——、ファイルでは区切り行（:--、:-:、--:）に保存されます。既定値 を選ぶと --- に戻ります。どれが有効かはメニューのチェックが示します：画面上では --- の列と :-- の列は同じに見えます。

目次は画面にあるものを示します。 見出しの一覧は、今見ている面から作られます。書式付き編集では、入力したばかりの見出しがテキストエディタに届くのを待たずすぐに現れます。読書モードでは、![[ノート]] で埋め込んだノートの見出しも含まれます——それも読んでいる内容の一部だからです。項目をクリックすると、どちらの場合も正しい見出しに移動します。また 分割モード ではスクロールが双方向になりました：読書側をスクロールするとテキストエディタも一緒に動きます（逆方向は以前からです）。

入力しながら記法が書式に変わります。**テスト** と打つと太字に なり、アスタリスクは消えます。*斜体*、~~取り消し線~~、 `コード`、アンダースコアの形も同じです。行頭では #  から ######  が見出しに、-  と 1.  が リストに（打った数字がリストの開始番号になります）、- [ ]  が チェックボックス付きのタスクに、>  が引用に、 --- だけの行は Enter で水平線になります。何かが描かれる記号は スペースの時点で効きます。見出しだけは最初の文字を待ちます — 空の見出しでは 画面に何も出ないからです。Ctrl+Z は変換だけを元に戻し、 記法をそのまま残します — アスタリスクを本当に書きたかった人の逃げ道です。貼り付けも変換します。記法を含むテキストを貼り付けると、記号なしで書式が付いた状態で入ります。ここでの判定は入力時より慎重で、明確な記法のときだけ働きます — 貼り付けでは結果ができあがる様子が見えないからです。おかげで * や _ だらけのコード片はコードのままです。コードブロックの 中では何も変換しません。そこでは記法そのものが主題だからです。すべて止めるには 設定 → 全般 → 入力中に記法を変換する。 Wordや Google ドキュメント、Web ページからは、構造を保ったままテキストが入ります。見出し、リスト（内部的にはリストではない Word のものも含む）、表、リンク、行内コード、言語付きのコードブロックです。元のフォント・サイズ・色は入りません。Markdown にはそれを表す方法がなく、残しても保存時に消える青い Arial の範囲が残るだけだからです。 一緒に貼り付けられた画像は、Word やブラウザーが一時フォルダー（自動的に空になります）に置いたものなら、ノートの添付ファイルになります。インターネットを指す画像はそのまま残り、そのコンテキストメニューに 画像をワークスペースにダウンロード があります。

画像・リンク・ウィキリンク

画像とリンク。画像を入れる方法は 3 つあります — バーの 挿入 → 画像…、![](foto.png) と入力する、そして ファイルをドラッグして入れる方法です。画像をドラッグすると画像が、 .md のノートをドラッグすると [[ウィキリンク]] が入り、 それ以外のファイルはファイル名をラベルにしたクリックできるリンクになります。 複数をまとめてドラッグすると、それぞれが別の行に入ります。保存されるパスはできるかぎり ノートのフォルダーからの相対なので、保管庫を移動してもノートは動き続けます。 リンクのアドレスは本文に出てきません（見えているのはラベルです）。そのため マウスを重ねるとステータスバーに表示され、Ctrl+クリックで開きます — ウェブのアドレスはブラウザーへ、ローカルのパスは LightNote で開きます。

できあがったリンクを編集するには、その中にカーソルを置いて リンク ボタン（または右クリックの リンクを編集…）を使います。ダイアログは テキストとアドレスが入った状態で開きます。リンクの上の右クリックには リンクのアドレスをコピー と、テキストを残してリンクだけ外す リンクを削除 もあります。[[ウィキリンク]] の上では ノートを開く と リンク先をコピー が、#タグ の上では タグを検索 と タグをコピー が出ます。画像の上では 代替テキスト…（書式モードでは 見えませんが、ファイルと検索には入ります）と、ハンドルで幅を変えたあとに 元のサイズ が出ます。ウェブのアドレスの画像の上では 画像をワークスペースに ダウンロード が出ます。ファイルはノートの隣の 添付/ に入り、ノートは そこを指すようになります — そうしないと、その URL が残り続けることに頼ることに なります。 そして最短の道もあります。テキストを選んで URL を貼り付けると、選択が 置き換わるのではなく [テキスト](URL) になります。編集用の二つの画面の どちらでも働きます。 ダウンロードされるまで、ウェブの画像は住所とメニューの道筋を書いた カードとして表示されます。LightNote はノートを描くためにネットワークへ出ないので、 以前はそこに壊れた画像の空の枠が出るだけで、どうすればよいか分かりませんでした。

書式は解除もできます。 書式 メニューの ハイライト、 上付き、下付き は、カーソルがその中にあるとき チェック が付き、 そこをクリックすると書式を再適用するのではなく 外します。キーボードには近道が あります。書式付きの範囲の 末尾 にカーソルを置いて Ctrl+Shift+Backspace を押すと、記法が 1 文字欠けた字面どおりの形で戻り ——太字 が通常の文字の **太字* になります——、足りない 区切りを補えばもう一度書式になります。太字・斜体・取り消し線・コード・ハイライト・ 上付き・下付きで使えます。Backspace だけなら 1 文字を消します。ほかの場所と 同じです。

ノートを離れずに図を編集できます。書式付きエディターでは、Mermaid の図や $$…$$ の数式は描画されて表示されます。ソースに触れるには、その上に カーソルを置いて Ctrl+Enter を押すか、コンテキストメニューのこのブロックを編集… を使います。下のバーにテキストが出て、開いている間ノートはロックされ、閉じる操作（✕、Esc、 Ctrl+Enter、ノートのクリック）は適用です。戻る道は Ctrl+Z です。同じメニューの 新しいノートに切り出す…は、選択した範囲をこのノートの隣にある新しいノートへ書き出し、 その場所に [[wikilink]] を残します。マークアップも一緒に行くので、見出し・ リスト・表がそのまま新しいノートに届きます。フィールドには中身だけが出ます。```mermaid と ``` の行（または $$）は、バーのヘッダーにある種類のセレクターになりました。ここで図・数式・コードブロックを切り替えることもできます。Enter は行のインデントを保ちます。Mermaid のようなインデントされた言語では、それが毎行の操作だからです。そしてブロックのコンテキストメニューにはMarkdown コードをコピーと画像をコピーがあります。コードはどの Markdown エディターに貼っても再び描画され、画像はメールやチャットに貼れます。どちらも読書のみモードでも使えます。

変更を AI に頼む。ブロックのバーが開いているとき、見出しの AI ボタンを押すと、何を変えるかを書く行が開きます — 「最初に戻るエラー経路を追加して」、「和を積分に置き換えて」 — Enter で送信します。入力欄のとなりのボタンはどの AI が答えるかを 示します。そのメニューではこのブロックだけ担当を切り替えられ（既定の AI は 変わりません）、送信内容を表示 も入っています。一度見ておく価値があります。 AI にはブロックのほか、ノートのタイトルと見出し、そして周囲の文章が 渡されるからで、だからこそ「そこに書かれている内容を図に反映して」と頼めます。 答えはフィールドに入り、図はその場で描き直されます。Ctrl+Z で自分が書いた ものに戻ります。LightNote は自前のレンダラーで答えを検査し、描画できないとき は、拒否した行とコマンドをモデルに伝えて一度だけ修正を求めます。それでも だめなら答えをそのまま書き込み、理由をバーに残すので、二行を手で直せます。 ボタンは図・数式・化学構造にだけ現れます。

セクションを指すことと、プロパティで札を付けること。 [[ノート#セクション]] はそのノートをそのセクションで開きます（アンカーは 見出しの文字列を指します）。![[ノート#セクション]] はそこだけを取り込みます （同じか上の階層の次の見出しまで。小見出しは含みます）。どの見出しにも当たらないアンカーは ステータスバーで知らせ、取り込みは書いたまま残ります — そこにノート全体を入れるのは、黙って 別のものを渡すことだからです。そしてフロントマターの tags: がノートのタグとして 数えられるようになりました。二つの書き方（tags: [a, b] と行に分けた一覧）の どちらでも、本文の #タグ と一緒に、ベース・タグ検索・アシスタントが見るものに 届きます。 ノート名を書かなければ、アンカーはそのノート自身を指します。[[#結論]] はタブを開かずにその見出しへ飛び、![[#結論]] はその節を今いる場所に取り込みます。アンカーは入れ子にもなります。[[論文#方法#標本]] は方法の中にある標本であって、ノートで最初に出てくる同名の見出しではありません。 三つめの形はブロックを指します。^id で終わる行（またはブロックのすぐ下にある ^id だけの行）が [[ノート#^id]] の行き先です。LightNote はこの識別子を作りません。あなたが書いたものへ案内するだけです。ノート以外が相手のときは、アンカーはその中の位置を指します。[[論文.pdf#page=3]] は PDF をそのページで開きます。

タグパネル。 サイドバーの帯にタグのセクションがあります：ノートにあるすべての #タグ のツリーで、/ で入れ子になります（#project/alpha と #project/beta は project の枝になります）。横の数字はノート数で、出現回数ではなくノート単位で数えます。タグを選ぶと、そのタグを持つノートが下に並びます（親は枝のノートも見せます）。ダブルクリックでノートが開きます。パネルは索引を読むので、本文の #タグ とフロントマターの tags: の両方が見えます。ノートの中のタグを Ctrl+クリックすると、このパネルがそのタグを選んだ状態で開きます——以前は #タグ の全文検索が開きましたが、それではフロントマターで宣言したノートは見つかりません。本文中の文字どおりの出現を探すときはグローバル検索を使ってください。

ウィキリンク: [[ と入力するとワークスペースのノートで自動補完され、 リンクは ]] で自動的に閉じます。Ctrl を押しながら [[ノート]] をクリックすると対応するノートが開きます。 接続パネルにノート間のつながりが表示されます。 Obsidian の埋め込み画像も表示されます。![[写真.png]] は画像として描かれ、![[写真.png|300]] は幅も反映します。ファイルには書いたとおりの記法が残り、画像のパスがトークンの代わりに保存されることはありません。 画像ではない添付はカードになります: ![[論文.pdf#page=3]]、![[講義.ogg]]、![[地図.canvas]] はファイル名の付いた枠として表示され、クリックできます。PDF は指定したページで開きます。Obsidian の .canvas と .base には一行が加わり、ファイルはフォルダーに残るが LightNote では描画されないことを伝えます。存在しない対象は書いたままで残ります。そこにカードを出すと、失われたファイルを約束することになるからです。 文の途中では、画像は同じように表示され、添付ファイルはファイル名だけになり、Ctrl+クリックで開けます。そこに枠を置くと段落が分かれてしまうからです。 同じノートを別の名前で: ノートのプロパティに aliases: [サンプリング, 標本抽出法] と書くと [[サンプリング]] でそのノートが開きます。別名は [[ の自動補完にも出ます。その名前のファイルがある場合は常にファイルが優先されます。別名はフォルダーのインデックスから来ます。アプリはワークスペースを開いたときにバックグラウンドでそれを作り直すので、書いたばかりの aliases: が効くのは次のスキャンからで、同じ瞬間ではありません。

ボックス・脚注・拡張記法

リッチな読書: フェンスで囲まれたコードブロックは言語ラベルとコピー リンク付きのボックスで表示されます。~~取り消し線~~ と ==ハイライト== が描画され、GitHub 風のコールアウト （> [!NOTE]、[!TIP]、[!WARNING]、 [!IMPORTANT]、[!CAUTION]）は色付きのボックスになります。 #hashtag タグは強調表示され、Ctrl+クリックでそのタグの検索を開きます。 先頭の YAML フロントマターブロック（---）も強調されます。タブ ツールバーには、ノートを PDF/HTML でエクスポートするボタン、中央寄せで 切り替え可能な読み取り列、ノートの表示モードの切り替えがあります。 Zen モード（F11）とタイプライタースクロールは、気を散らさずに 執筆するのに役立ちます。

脚注は双方向にジャンプします。 参照 [^1] は上付きの番号として表示され、Ctrl+クリックで定義へ移動します。定義側では [^1]: のマーカーがそのまま見えます。ジャンプの行き先であり、どの脚注を編集しているのか分かる必要があるからです。そこを Ctrl+クリックすると参照へ戻ります。多くの Markdown ビューアーとは違い、エディターは脚注に番号を振り直しませんし、定義を末尾へ移動もしません。ファイルの並び順はあなたのものです。 Obsidian と Pandoc のインラインの書き方 —— ^[脚注の本文] —— も描画されます。呼び出す位置に本文を書くだけで、閲覧モードでは末尾に番号付きで並びます。ファイルには書いたままが残り、書き出しでは Word・LaTeX・Typst・EPUB の本物の脚注になります。

MkDocs のアドモニション（!!! note と 4 スペースで字下げした本文）は、書式付き編集では書かれたそのまま保たれます。本文をアドモニションに属させているのがその字下げだからで、そのぶん中の文字には書式が付きません。かわりに、ノートを開いて保存しても構造が壊れません。

閉じ記号のあるボックスもボックスとして表示されます。 :::tip … :::（Docusaurus）と <details> … </details> は、コンパクトな書き方でも空行を挟む書き方でも、色付きのバーとタイトルが付きます。開始の記号は種類のラベル、あなたが書いたタイトル、または <summary> の文字に置き換わります。閉じの記号は画面から消え、ファイルには残ります。アプリ自身が書いた記法を、そのままの文字としてページに残さないためです。画面に残るのはボックスの最後の行で、ボックスの範囲を決めているのはその行です。中に書き続けるためにカーソルを置く場所でもあり、削除できません。削除できてしまうと、下の内容がボックスに飲み込まれます。テキストを残したままボックスをやめるには、右クリックのボックスを解除を使います。定義リストの : は引き続き淡色になります。 <summary> がタイトルになるのは <details> と同じ行にあるときだけです。別の行に置くと書いたまま表示され、ボックスは既定のラベルのままになります。

インライン HTML とコードブロック。 <kbd>、<mark>、<sub>、<sup> は書式付き編集でも描画されます。タグは消えて中身だけが残り、読書モードと同じ見え方になります。フェンスで囲まれたコードブロックにはボックスが付き、隅に言語名と コピー が出ます。コードをいちばんコピーする書式付き編集と読書モードで使えるリンクです。押すとフェンスの中身だけ（マーカーなし）を取り、しばらく コピーしました と表示します。どちらのラベルも、コードの上に重ならずに収まるときだけ出ます。

読書のその他: 先頭の YAML フロントマターのブロックは表示されません。プロパティパネルで編集します。#hashtag のタグはクリックできるラベルになり、そのタグの検索を開きます（エディターでの Ctrl+クリックと同じです）。Obsidian 形式のコメント（%%これは表示されません%%、または %% だけの行で挟んだブロック）はファイル内にだけ残ります。GitHub のコールアウトに加えて、Docusaurus（:::tip タイトル … :::）と MkDocs（!!! note "タイトル" と字下げした本文、??? note）の書き方も同じ枠で表示されます。ドキュメントのリポジトリを読むときに便利です。

読書の新機能: ~~取り消し線~~ と ==ハイライト== に加えて、上付き ^x^、下付き ~x~、ショートカット絵文字（:rocket:）、URL の 自動リンク、脚注 [^1]、折りたたみブロック <details>、定義リスト、タスク - [ ]/- [x]（⬜/✅）、そして [TOC] マーカー（クリック可能な目次）が使えます。ローカル画像や インライン HTML（<kbd>、<mark>…）にも 対応します。目次パネル（タブのツールバー）は見出しをたどってカーソルに 追従し、挿入ボタン（または右クリックメニュー → 書式/挿入）であらゆる記法を適用できます。

見出し・フォルダー・テキスト操作

見出しの固定（スティッキースクロール）： スクロールすると、最上行を含む見出しがエディター上部の帯に固定されます。クリックするとそのセクションへジャンプします（設定 → Markdown で切り替え）。ツリーでフォルダーを右クリックするとフォルダーノート（フロントマター付きの index.md）を作成／開けます。索引として便利です。

フォルダーノートとファイル一覧： フォルダーをダブルクリックすると、その index.md があれば開きます。どのノートでも、行に単独で置いた [files]（または [arquivos]）トークンは、書式付き編集と読書でノートのフォルダー内ファイルの一覧（クリックできるリンク）に置き換わります。[TOC] と同様にその場で生成され、ファイルには何も書き込みません。

テキストと行の操作。 コードエディターの操作はノートでも使えます — タブのバーの 書式 ボタンの テキスト サブメニュー、右クリックメニュー、編集 メニューの 行・ クリーンアップ サブメニューから：行（または選択した複数行）を上下に移動 （Ctrl+Shift+↑/↓）、複製（Ctrl+Shift+D）、削除 （Ctrl+Shift+L）、並べ替え（A→Z / Z→A）、順序の反転、行の結合、 重複行・空行の削除、スペースの削除、大文字小文字（大文字／小文字／反転）。 行に連番を付ける…では開始・増分・先頭のゼロ・区切りを 指定でき、既定値（". "）なら正しい Markdown の番号付きリストになります。 選択があればその範囲だけ（行単位に拡張して）、なければ文書全体に適用され、いずれも元に戻す 操作は 1 回で済みます。タブのバーには AI ボタンもあります。AI に質問 / AI で編集 はコードと同じ Ctrl+K / Ctrl+I で、ノートに質問 はワークスペースのノートを使って答えるチャットです。

折りたたみ可能な見出し: 見出しの左の小さな矢印をクリックする（または Ctrl+Shift+[ / Ctrl+Shift+] を使う）と、セクションを折りたたんだり展開したり できます。表示メニューにはすべての見出しを折りたたむ/展開するがあります。 折りたたみは見た目だけで、ファイルには一切書き込まれません。LightNote はセッション間で 状態を記憶します。目次や検索から折りたたまれたセクション内へ移動すると、自動的に 展開されます。

バインダー: フォルダーを 1 つの作品として

これは何か: ノートが宣言した順序で 章 になるフォルダーです。本、卒業論文、講座、マニュアル、ランブック、作業日誌のいずれにも同じ仕組みが使えます。フォルダーのコンテキストメニューの バインダーにする を選ぶと、現在の順序でノートが並んだ画面が開きます。ドラッグして並べ替え、確定してください。順序はフォルダーの index.md の chapters: キーに保存されます。自分のテキストファイルなので、ノートと一緒に移動し、どの端末でもそのまま効きます。 サブフォルダーも順序に書けます。その章はサブフォルダーが現れた位置に入り、サブフォルダーは自分の index.md に自分の順序を宣言します — 本が「部」を持つのはこの仕組みです。サブフォルダーの表紙は文書のページにはなりません。その階層の順序を宣言し、移動するためにあります。

移動する: 順序が宣言されていると、ノートのバーに 第 3 章 / 全 12 章 が表示され、両側に矢印が付きます(Alt+PgUp と Alt+PgDn)。真ん中のボタンはすべての章を一覧します。アウトライン パネルは 2 階層になり、作品の章と、開いている章の見出しを表示します。作品の端では矢印が灰色になります。順序を宣言していないフォルダーではどれも現れず、これまでどおりのままです。

ノートのテンプレート: バインダーは、その中で作成するノートがどの テンプレート から始まるかを宣言できます(template: キー)。既製のテンプレートは 5 つ — 本の章、卒業論文の章、授業、手順のステップ、日誌のエントリ — で、選ぶと Templates フォルダーにファイルとして保存され、編集できます。バインダーの 中 で作成したノートは自動で順序に入ります。外から置かれたファイルは、取り込むまで 順序の外 に並びます。章の名前を変えるとキーも直り、位置はそのまま保たれます。 出来合いの構成から始めるには、フォルダーのコンテキストメニューの テンプレートから構成… が二つのキー——順序と章のテンプレート——を一度に書き込みます。すでに書いた表紙はそのまま残ります。宣言された章がまだ存在しないあいだは、目次 に一度でまとめて作成するボタンが出て、どの章もフォルダーのテンプレートから生まれます。上書きはしません。すでにある章はそのままです。

1 つの文書にまとめる: フォルダーを書き出すとき、章を 1 つの文書にまとめる にチェックすると、宣言した順序の章が入った 1 つ のファイルができます。テキストは描画の 前 に結合されるので、脚注・図・表・引用は文書全体で通し番号になり、ある章から別の章の図への相互参照も機能するようになります。宣言した順序にないものは含まれず、レポートがそれを伝えます。

プロパティ・テーマ・ズーム

ノートのプロパティ: プロパティサイドパネルは YAML フロントマターを 型付きフィールド（テキスト、数値、日付、チェックボックス）として表示し、上部に 種類のボックスがあります。種類とプロパティを設定することで、ノートを ベースにまとめられます。

ノートのテーマ: プロパティパネルのテーマボックスは、 アプリ全体のテーマを変えずに、このノートの見た目（本文の色とフォント）を決めます。 選択はフロントマター（theme キー）に書き込まれるため、 ファイルと一緒に移動します。どのマシンで開いても同じ見た目になります。 隣のボタンは色をノート自体に書き込むので、そのテーマを持っていない相手でも同じ見た目になります。 キーがなければ、ノートはワークスペースのテーマに従います。 外部から届いたノートで見た目が変わってほしくない場合は、 設定 → Markdown のノートで宣言されたテーマを尊重するをオフにしてください。

LightNote がまだ知らないテーマ: テーマの一覧はサイトから ダウンロードされる 1 つのファイルです。そのため、最後の更新より後に公開された テーマを指定したノートは、単純にそれを見つけられません。その場合ノートは ワークスペースのテーマで開き、プロパティパネルがその旨を知らせ、 利用できるテーマを見るための近道を示します。LightNote は最新の一覧を自分で 探します — 1 セッションにつき 1 回、バックグラウンドで、ノートを 待たせずに行います。何も取得してほしくない場合は、 設定 → 機能のツールカタログをオンラインで取得をオフに してください。

Ctrl++ と Ctrl+−（または Ctrl+マウスホイール）でノートの大きさを変えられ、Ctrl+0 で 100% に戻ります。すべてのノートのフォントを変えずに、長いノートだけ読みやすくできます。エディターと読書は一緒に拡大縮小されるので、分割表示でも左右が同じ大きさのままです。ノートに直接書いた <svg> も読書に描画されるので、AI が作ったグラフを別ファイルにせずそのまま貼れます。

語数と、その範囲。ステータスバーはノートの語数を数え、読む のにかかる時間を見積もります。その隣のセクション N は、カーソルが いるセクションの語数です —— 見出しから、同じか上の階層の次の見出しまでで、 アウトラインが太字にしているのと同じ範囲です。設定 → ノートと執筆 で1日の目標を決めると、今日 N/M も出ます。数えるのは、今日開いた ノートで増えた分です。消しても減りません —— 自分の文章を直すことが罰に なってはいけません ——、開かなかったノートは入らず、日付が変わるとゼロに 戻ります。

図（Mermaid）

仕組み

Mermaid 図。 ```mermaid のフェンスにフローチャート（flowchart/graph、四方向すべて）、シーケンス図（sequenceDiagram）または円グラフ（pie）が書かれていると、読書モード、エクスポートしたファイル、そして図がいちばん多く届くノートに質問の回答で、図として描画されます。描画はノートのテーマ（文字色・紙・アクセント）に従うので、どちらのテーマでも周りの文章になじみます。書式付き編集（既定のモード）でも図は描画されます。図の上にはブロックのバー（コピー・編集・削除）が出ます。編集を押すと下にソースのバーが開きます。開いている間ノートはロックされ、図は入力しながら描き直されます。閉じると適用され（保存もキャンセルもありません）、Ctrl+Z は変更全体を一度で取り消し、欄を空にするとブロックが削除されます。分割モードでは、図をクリックするとカーソルが素のテキストのフェンスへ移動します。テキストエディターではすべて文字のままです。図を見るには Ctrl+E を使ってください。リストの項目の中では、図 (SMILES の構造式、ブロックの数式、[files]、![[ノート]] も同様) は書式付き編集ではテキストのままで、読書モードで描画されます。そこでは項目の記号をファイルに戻す方法がないためです。

サブグラフ（subgraph … end、入れ子も含む）は見出し付きの枠として描かれ、辺は本物のノードから枠の境界を越えて伸びます。サブグラフの id を辺の端点にすることもできます（sub --> X）。作者が指定した色も反映されます: classDef、class、:::クラス、style（塗り、枠線、太さ、破線、文字色）。作り始めるにはノートのバーの挿入 → 図（Mermaid）を使ってください。選んだ種類のひな形がそのまま入ります。メニューにはよく使う六つが直接並び、すべての図…から 33 種すべての選択画面が開きます。用途ごとにまとまっていて、検索（名前でも、図が示す内容でも）と、それぞれの実際に描いたプレビューが付きます。33 種もあると、名前を読むより絵を見るほうが速く決まります。図のフロントマター（先頭行の前にある --- のブロック）も読みます。title は図の上に描かれるタイトルになり（本文の title が優先）、LightNote が知っている config のキーは図に届きます（gitGraph.mainBranchName、gantt.displayMode、そして packet の bitsPerRow、行を左右反転する bitOrder: descending、showBits: false）。知らないキーは無視され、ノートを拒否しません。

シーケンス・エンティティ・クラス・状態

シーケンス図では participant/actor（as 付き）、矢印の各形（->>、-->>、-x、-)）、活性化（+/- と activate/deactivate）、ノート（Note left of/right of/over）、loop/alt/else/opt/par のブロック、そして autonumber が使えます。まだ描画できないもの — ほかの図の種類 — は今までどおり色付きのコードブロックとして表示されます。サブグラフ内の direction と linkStyle は無視されます。 Mermaid v11 のノード記法（A@{ shape: rounded, label: "テキスト" }）を読み取り、v11 の図形カタログを描画します。doc、lin-doc、docs、tag-rect、win-pane、hourglass、bolt、flag、das などで、それぞれの名前が示す記号そのものです。長方形で代用しないのは、書類の代わりに長方形を描くことが別の図になるからです。Mermaid にない名前は行番号付きでコードブロックに戻ります。エッジ ID（A e1@--> B）と e1@{ animate: true } は受け付けたうえで無視します。アニメーションは描画しません。型付き参加者（participant DB@{ "type": "database" }）はライフラインの上に UML の記号を描きます——boundary、control、entity、database、queue、collections ——ここで宣言した "alias" は as と同じ働きをします。

erDiagram も描画されます。各エンティティは属性付きのボックスになり、関連の両端にカーディナリティが表示されます（||--o{、}o--||、|o、|{）。-- は識別関連、.. は非識別関連です。エイリアス p[Person] は、関連が参照する id を変えずにボックスの名前を決めます。subgraph … end もここで使えます。中のエンティティはタイトル付きの枠に入り、サブグラフは入れ子にでき、枠の ID を関係の端にできます（CLIENTE ||--o{ Vendas : faz）——その場合は同名のエンティティではなく枠の境界につながります。

classDiagram も同様です。3 つの区画（名前、属性、メソッド。メソッドの括弧で分かれます）を持つボックス、独立した行の <<interface>>、ボックスになる namespace、そして 6 種類の関連（<|--, *--, o--, -->, ..>, ..|>）に対応します。向きに注意: A <|-- B では三角が A 側に付き、継承するのは B です。引用符のカーディナリティは両端に表示されます（"1" --> "*"）。ジェネリクス List~T~ は List<T> として表示され、メンバーでも同様です。ロリポップインターフェース（bar ()-- foo）は、() がある側の箱の上に円を描き（その側だけ）、関係線はその円に接します。namespace も入れ子にでき、内側の } のあとはクラスが外側の namespace に戻ります。

stateDiagram-v2 は状態機械を描きます。[*] は開始（塗りつぶした円）と終了（環のある円）、state X { … } はボックス、<<fork>>/<<join>> はバー、<<choice>> はひし形になります。複合状態の中の -- は並行リージョンを区切り、破線で示されます。

タイムライン・ジャーニー・象限・ガント

timeline も描画されます。各期間はタイムラインの列になり、その下に出来事が積み上がります。section は時代を色帯でまとめます。複数の出来事は同じ行にコロンで並べる書き方（2004 : Facebook : Google）と、次の行に続ける書き方（: 別の出来事）の両方が使えます。ここでは title・section・direction 以外の行はすべて自由な文字列です。direction TD（縦向きのタイムライン）はまだ描画できず、コードブロックのままになります。

journey（ユーザージャーニー）も描画されます。各タスクはジャーニーの軸の上のボックスになり、1 から 5 の評価が顔を上下に動かします。その顔が描く起伏こそ、この図が見せるためにあるものです。section はフェーズをまとめ、アクターはタスク上の色付きマーカーになり、凡例が左側に出ます。ここでの文法は timeline と違って厳密です（タスク: 評価: アクター, アクター）。名前と評価の組がなければ顔を置く場所がないので、形の崩れた行や 1〜5 の外の評価は行番号付きで図を拒否します。

そして quadrantChart は四象限の平面を描きます。x-axis と y-axis が各軸の両端に名前を付け（--> の右側は省略できます）、quadrant-1 から quadrant-4 が各領域のラベルになり、点は 名前: [x, y] の形で、x と y は 0 から 1 です。番号に注意してください。これは読む順ではなく数学の平面の番号です。quadrant-1 は右上で、そこから反時計回りに進みます。y = 1 は上端です。点の色と半径は直接（P: [0.5, 0.5] radius: 10, color: #109060）でも、クラス（P:::クラス と classDef）でも指定でき、直接指定がクラスに勝ちます。0〜1 の外の座標は切り詰めずに行番号付きで図を拒否します。座標は平面上の位置なので、切り詰めると書いていない象限に点が入ってしまうからです。

gantt は工程表を描きます。dateFormat は書き込む日付の書式（既定は YYYY-MM-DD）、axisFormat は軸ラベルの書式（%m/%d）を指定し、section がタスクを帯にまとめます。各タスクは テキスト : 印, id, 開始, 終了 の形です。印の done・active・crit・milestone は先頭に置き、組み合わせられます。開始は日付か after 別のid、終了は日付・期間（5d、2w、3h、45m）・until 別のid のいずれかです。項目が一つだけなら、前のタスクが終わった時点から始まります。after はノートの後ろで宣言されたタスクも指せます。一方、どこにも存在しない id や循環する依存関係は、バーを今日の日付に置くのではなく、行を示して図を拒否します。excludes weekends（excludes monday や日付も可）は除外した日の分だけ各タスクの終了を後ろにずらすので、バーの長さが変わります。includes 2026-03-07 は週末より優先され、その土曜は稼働日だと伝えます。マイルストーンはひし形で表示され、todayMarker off は今日の線を消します。同じ行に複数のタスクを積む displayMode compact も描画します。ここでは、タスクが占める範囲（ラベルを含む）が既存のものに触れないときだけ同じ行を共有します。vert マーカー（開始 : vert, v1, 20:15, 0m）は瞬間を図全体を貫く垂直線として描き、行を占有せず、ラベルは軸の下に出ます。dateFormat X（または x）は日付を秒（またはミリ秒）単位の Unix 時間として読み、軸では %s/%Q がそれを書き戻します。Mermaid が知らない tickInterval（1decade）は本家と同じく黙って無視され、軸は自動に戻ります。

マインドマップ・要求・Git・C4

mindmap では階層をインデントが決めます。項目の深さは、その本文が始まる桁そのもので、括弧も矢印も使いません（タブは次の 4 の区切りまでと数えます。エディターと同じ勘定です）。最初の項目がルートで、その桁にもう一つ項目が来れば二つ目のルートになってしまうため、そこで図は行番号付きで拒否されます。各項目は形を宣言できます —— [四角]、(角丸)、((円))、{{六角形}}、))爆発((、)雲(。区切りがなければ角丸になります。::icon(...) と :::クラス は認識したうえで無視します（アイコン用フォントを同梱しておらず、クラスはここに存在しない外部 CSS を指すからです）。描画は左右の二方向で、ルートを中央に置いて枝を振り分け、枝ごとに色を持ち、その色は子孫が受け継ぎます。枝は深くなるほど細くなります。これは木であって、mermaid のような力学シミュレーションではありません。マインドマップでは階層こそが中身なので、位置から読み取れる必要があります。しかも図はテーマを変えるたびに描き直されるため、ランダムな初期位置から収束する配置では地図全体が毎回組み替わってしまいます。

treeView（treeView-beta）はプロジェクトのフォルダー木を描き、二つの書き方を受け付けます。字下げ（自分で打つ場合）と、tree コマンドそのものの文字（├──、│、└──）です。後者があるからこそ、端末の出力をそのまま貼り付けられます——そこでは字下げだけでは足りず、│ と空白は同じ列を占めるのに、枝が続くと言えるのは前者だけだからです。末尾のスラッシュはフォルダーを示し（src/）、空白を含む名前は引用符で囲み、## テキスト は行末にコメントを付け、:::highlight は名前を強調します。icon(...) はマインドマップの ::icon() と同じく、認識したうえで無視します。アイコンパックは JavaScript 経由で Iconify から来ており、Mermaid 自身も既定では描きません。

ishikawa（ishikawa-beta）は原因分析の特性要因図（魚の骨）を描きます。最初の項目が「結果」（右端の頭）で、次の階層がカテゴリ（大骨）、その内側二つが要因と子要因です。階層は三つまでで、四つ目は行番号を示して拒否します——Mermaid に存在しないからです。大骨は背骨の上下に交互に伸び、隣り合うカテゴリの文字が重ならないようになっています。要因を書いた順は、どちらの側でも上から下へ読めます。

venn（venn-beta）は重なり合う集合を描きます。set A["望ましい"] で一つ宣言し、union A,B["作れる"] で共通部分に名前を付け（合成は交わる集合の名で呼びます）、その直下の text A1["React"] でその領域に項目を入れます。集合は三つまでで、四つ目は行番号を示して拒否します——円四つではすべての領域を作れる配置がなく、「ほぼ正しい」図は宣言された領域を隠してしまうからです。ラベルの後ろの :数字（set A["Alpha"]:20）は円の大きさを変え（面積が数字に従います）、交わりの大きさは変えません。交わりまで比例させるのは別の図（オイラー図）で、数値最適化が必要になります。style A fill:#ff6b6b は集合を塗り、カンマ付き（style A,B color:#333）ならその集合たちの合成にかかります。

cynefin（cynefin-beta）は意思決定を分類するスノーデンの枠を描きます。五つの領域は名前が固定で——complex、complicated、chaotic、clear、confusion——位置も固定（四つの象限と、真ん中の confusion）です。選ぶのはそれぞれの中身だけです。項目は一行に一つ、引用符で囲み、complex --> complicated : "パターンが見えた" で領域間の遷移を描きます。五つ以外の名前は行番号を示し、ある名前を並べて拒否します。clear と chaotic の境界は波打つ線で出ます。モデルではそこが崖だからで、形がそれを語ります——ここでは波は常に同じで、開くたびに図が変わることはありません。

swimlane（swimlane-beta）は、担当ごとのレーンで分けた工程を描きます。文法はフローチャートと同じ（形も矢印もラベルも classDef も）で、subgraph が箱ではなくレーンになります。すべてのノードはどれかのレーンに入る必要があり——外にあるノードは、誰の作業か言えないので拒否します——レーンの入れ子も拒否します。LR ではレーンが行で流れは右へ、TB では列で流れは下へ進みます。流れの上の位置は各作業への最長経路で決まり、帯は持ち主のものです。作業は、そのほうがコンパクトになる場合でも決して自分のレーンを出ません。

agentflow（agentflow-beta）は AI エージェントの流れを描きます。中身はフローチャートの別の語彙です：矢印は同じで、flow id["名前"] … end が subgraph の役割を果たし（入れ子も可）、global … end は全エージェントが参照するものを置き、connector id["名前"] は外部システムを宣言します。本当に違うのは形で、各ステップの役割を表します——@{ shape: input }、task、tool（ツール呼び出し）、decision、refdoc（参照文書）、action（最終の行動）。文書は -.- で、矢印なしでつなぎます。参照するだけで、流れのステップではないからです。エージェントを文で説明するキー（instruction、params、returns、connectorRef、protocol、endpoint）は読み取ったうえで描画では無視します。これらの形名はここだけで有効で、flowchart では拒否します——あちらでは Mermaid にもないからです。

usecase（usecase-beta）は UML のユースケース図を描きます。actor で宣言したものが人型になり、それ以外はすべてユースケースとして楕円で描かれます——この区別こそがこの図の目的です。ユースケースは Id("ラベル")、Id[ラベル]、Id だけ、引用符の文字列だけ、のどれでも書けます。systemBoundary "名前" … end がシステム境界で、note for X "テキスト" が注釈をつけます。関係は UML どおりで、--> が関連、--|> が汎化（白抜き三角が一般側）、A ..> : include B（対象はコロンのあと）が点線の「include」で、extend も同じです。アクターを説明するだけのキー（type、business、icon）は読み取って無視し、<<ステレオタイプ>> はラベルに入ります。json ノードはまだ描けず、コードブロックのままです。複数行に渡るデータの木だからで、そこでは JSON がテキストとしてそのまま読めます。

wardley（wardley-beta）は Wardley マップを描きます。縦軸は利用者からの見えやすさ（上が利用者に見えるもの）、横軸は Genesis から Commodity までの進化度です。組の順番に注意：component お茶 [0.63, 0.81] は [見えやすさ, 進化度] で、最初の数が縦軸です。逆に読むと地図はそのまま描けてしまい、別の戦略を語り出します。anchor は上の利用者、A -> B は連鎖（名前に空白を含められ、引用符は任意）、A +> B はフロー（太め。+<> は双方向、+'文字'> はラベル付き）、evolve ケトル 0.62 は進むべき先までの破線の矢印です。ほかに evolution（軸の段階名）、size、(build)/(buy)/(outsource)/(market)、(inertia)（抵抗のバー）、label [dx, dy]、pipeline X { … }、note、accelerator/deaccelerator、番号付きの annotation と annotations の凡例が使えます。

eventmodeling はイベントモデリングを描きます。三つのレーンの時間軸で、上が画面、真ん中がコマンド（とリードモデル）、下がイベントです。各行は tf 02 cmd AddItem の形で、数字が時点（列）、真ん中の語が種類でレーンを決めます——ui、cmd/command、pcr/processor、rmo/readmodel、view、evt/event（長い形も同じ）。レーンは宣言しません。それがこの手法そのものだからです。rf（resetframe）は新しいスライスを開き、破線の区切りが入ります——物語がやり直す場所です。スキーマは中括弧（{ description: string }）か、data … { … } ブロックへの参照（[[Data]]）で与えます。ブロックはあとに書いても構いません。->> 02 ->> 03 はその枠を支える時点を番号でつなぎます。

railroad（railroad-ebnf-beta、-abnf-beta、-peg-beta、railroad-beta）は文法を線路図として描きます。各規則が指でたどれる経路になり、書けるものがそのまま辿れるものになります。規則は 名前 = 式 ;（PEG は 名前 <- … ;）で、複数行にまたがっても構いません——閉じるのは ; です。引用符の文字列は終端記号（カプセル形）、裸の名前は別の規則（四角）です。|（または /）が選択、? が任意、+ が一回以上、* が零回以上、( )・[ ]・{ } がグループ・任意・繰り返しです。ABNF は繰り返しを前に置き（1*( ALPHA / "-" )、*DIGIT）、PEG は述語 !x・&x を受け付けます（入力を消費しないのでラベルに入ります）。railroad-beta は関数記法（sequence(choice(terminal("+"), …))）です。四つとも同じ絵になり、上の迴回が任意、下のループ（戻る向きの矢印付き）が繰り返しです。

requirementDiagram は要求と要素を区画付きのボックスとして描きます。宣言した種類（requirement、functionalRequirement、performanceRequirement、interfaceRequirement、physicalRequirement、designConstraint）は名前の上にギュメで表示され、id・text・risk・verifymethod の各項目が行になります（element では type と docref）。関係（satisfies、traces、derives、verifies、refines、copies、contains）は a - satisfies -> b または反転した b <- satisfies - a と書き、反転形では先に書いた名前が宛先です。実線になるのは contains だけで、記号は含む側に付きます。ほかは破線で、矢印は宛先側です。空白を含む名前は引用符で囲みます。

gitGraph はリポジトリの履歴を描きます。commit ごとに時間が進み、branch 名前 は新しいレーンを開いてそのままそこで作業を続け（git switch -c と同じ）、checkout で別のレーンに戻り、merge が二つを合流させます。属性はコロンで書きます：commit id: "テキスト" tag: "v1" type: HIGHLIGHT（REVERSE も可）、branch 名前 order: 2 はレーンの並び順を変えます。cherry-pick id: "…" には実在するコミットの id が必要です。形が種類を表します——通常のコミットは塗りつぶした丸、強調は四角、取り消しは X 付きの円、マージは二重の輪、cherry-pick は切れ目のある円——。テーマによってはパレットの二色が似て見えるため、形だけが両者を分けるからです。LR:（既定）、TB:、BT: で時間軸の向きが変わります。存在しないブランチへの checkout/merge は、頼んでいないレーンを勝手に作らず、行を示して図を描くのをやめます。

C4 系（C4Context、C4Container、C4Component、C4Dynamic、C4Deployment）も描画します。ここではすべてがマクロで、構文に矢印は一つもありません。各要素は、型をギュメで囲んだ行、太字の名前、その下の説明という箱になります：Person(alias, "名前", "説明")、System、Container、Component、および Db・Queue・_Ext の各種です。Container と Component では3 番目の引数が技術で（Container(app, "App", "C++/Qt", "役割")）、ほかでは 3 番目がそのまま説明になります。境界（Boundary、Enterprise_Boundary、System_Boundary、Container_Boundary、C4Deployment の Node）は波かっこを開き、入れ子も含めて見出し付きの枠になります。つながりは Rel(a, b, "ラベル", "技術") で、BiRel は両端に矢印を付け、Rel_Back は逆向きを指します。C4Dynamic は関係を出現順に番号付けします。位置のヒント（Rel_U、Rel_D、Rel_L、Rel_R）と Update…Style は受け付けたうえで無視します——配置はほかの図と同じレイアウトが決め、色はノートのテーマから来るからです。宣言していない別名を指す関係は、書いていない箱を勝手に作らず、行を示して図を描くのをやめます。

ボード・グラフ・パケット

kanban では字下げが構文で、二段階あります。外側がレーン、内側がカードです（id[ラベル]、あるいは本文だけ）。カードのあとの @{ ticket: LN-9, assigned: 'ana', priority: 'High' } はカードの本文には入りません。チケットと担当者は専用のフッターに置かれ、優先度（Very High、High、Low、Very Low）は左端の帯の色になり、暖色から寒色へ並びます。レーンはすべて同じ高さで終わり、カードのないレーンもそのまま残ります——空の列を示すのがそれだからです。これはノートの中で流れを説明するための描かれたボードです。カードをドラッグして実際に作業するボードは、アプリ本体のタスクパネルのほうです。

xychart（xychart-beta）は 2 本の軸の上に棒と折れ線を描きます。x-axis "見出し" [1月, 2月, 3月] でカテゴリを与え（空白やカンマを含む名前は引用符で囲みます）、y-axis "見出し" 0 --> 100 で目盛りの範囲を決め、bar [10, 40, 90] や line [20, 30, 80] がそれぞれ系列を 1 つ足します。値はカテゴリごとに 1 つ、宣言した順に対応します。値の数が合わない系列は、行を示して図を描かないことで知らせます。棒が別のカテゴリにずれ、グラフが別のことを主張し始めるからです。y-axis がなければ目盛りはデータから決まり、データが下に出ない限りゼロから始まります。最小値から始めると棒どうしの差が誇張されますが、それは誰も選んでいません。範囲を宣言した場合、範囲外の値は枠からはみ出さずに拒否されます。x-axis は連続した範囲（0 --> 100）も受け付け、書かなければカテゴリは番号になります。棒の系列が 2 つあるときは横に並べて描きます。mermaid のように重ねると後ろの系列が消えてしまうからです。xychart-beta horizontal はまだ描けず、コードブロックのまま残ります。縦向きに描くと、軸が入れ替わったグラフを渡すことになるからです。系列には名前を付けられます（bar "公開" [10, 40]、line "非公開" [20, 30]）。名前はプロットの上の凡例になり、塗りつぶしの棒・点付きの線という形で示されます——色だけでは区別できないからです。線の系列では値にラベルを付けられ（[540 "PaLM", 65]）、点の上に描かれます。棒では Mermaid と同じく無視されます。

radar（radar-beta）は、中心から伸びる軸の上に 1 本以上の曲線のプロファイルを描きます。axis a["ラベル"], b, c で軸を宣言し（この行は繰り返せます）、curve x["名前"]{80, 60, 90} で軸ごとに値を 1 つ与えます。値は軸を宣言した順に対応します。名前付きの書き方（{a: 80, c: 90, b: 60}）も使えます。向きに注意: 最初の軸は上を向き、回りは時計回りです。max と min は目盛りの範囲を決め（max がなければ読み取った最大値になります）、範囲外の値は切り詰めずに、行を示して図を描かないことで知らせます。ticks は輪の数を変え、graticule circle は輪を円にし、showLegend false は凡例を消します。軸の数と値の数が合わない曲線も同様に拒否されます。それは不完全な図ではなく、別の図になってしまうからです。

packet（packet-beta）はパケットのビット配置を描きます。各フィールドは 0-15: "ラベル" と書き、範囲は両端を含みます。0-15 は 16 ビットです。1 ビットだけなら 4: "ラベル"、相対形式の +16: "ラベル" は次の 16 ビットを取るので、途中にフィールドを挿入しても数え直す必要がありません。フィールドは隙間なく連続していなければなりません。隙間や重なりは、行を示して図を描かないことで知らせます。どちらも後続すべてを黙ってずらしてしまうからです。1 行は 32 ビットで、行をまたぐフィールドは両方の行に描かれ、ラベルは広いほうに入ります。格子の上の数字は各フィールドの開始位置と、各行の最後のビットを示します。

グリッド・面積・アーキテクチャ・フロー・ZenUML

block（block-beta）は箱のグリッドを描きます。位置は書いた順で決まります。columns 3 で列数を決め（書かない場合はすべて 1 行に並びます）、各箱はフローチャートと同じ形（a["ラベル"]、b(("円"))、c{"ひし形"}）を受け付け、a:2 は箱に 2 列分を占めさせ、space（または space:2）は空きを作ります。block:id … end はグリッドの中にグリッドを入れ子にし、独自の columns を持ち、周りが枠になります。矢印はフローチャートのもの（a --> b、ラベル付きは a -- "文字" --> b）ですが、ここでは宣言済みのブロックを参照するだけです。存在しない名前への矢印は、書いていないセルに箱を作らず、行を示して図を描かないことで知らせます。列の間隔は矢印のラベルが収まるまで広がり、隣の箱に触れません。ブロック矢印（a<["往路"]>(right)）は矢印の形をした箱です。向きは括弧の中に書き（right、left、up、down、水平両方の x、垂直両方の y）、組み合わせられます（(x, down)）。存在しない向きは、適当な矢印になるのではなく行番号を示して図を拒否します。

treemap（treemap-beta）は面積の地図を描きます。各長方形の面積は値に比例し、字下げで入れ子になり、深さに制限はありません。葉は値を宣言し（"名前": 12）、セクションは何も宣言しません。その値は子の合計で、独自の合計を許すと自分の中身について嘘をつく長方形ができてしまうため、行を示して図を描かないことで知らせます。空白やコロンを含む名前は引用符で囲みます。classDef と :::クラス で色が付きます。配置は squarified で、長方形を正方形に近く保ちます。いつも同じ軸で切ると目で比べられない細長い帯になり、面積を比べることがこの図の唯一の役目だからです。ラベルと値は長方形の中に丸ごと収まるときだけ表示されます。縁で切れていては何も伝わらないからです。

architecture（architecture-beta）はサービスとその間の接続を描きます。service api(server)[API] で構成要素を宣言し、group kumo(cloud)[クラウド] で境界を開き、in kumo を付けるとサービスがその中に入り（グループは入れ子にできます）、junction j は接続を折り曲げる角を作ります。位置を決めるのは接続の「辺」です。 a:R -- L:b は a の右辺を b の左辺に付けるので、b は a の右に置かれます。L、R、T、B が使え、矢じりは < や > のある側に出ます（-->、<-->、矢じりなしの --）。端に付けた {group} は、線を中の箱ではなくグループの境界へ向けます。アイコンは Mermaid が内蔵する 5 つだけです — cloud、database、disk、internet、server — 。それ以外の名前は、行を示し、使える名前を挙げたうえで図を描きません。残りは（logos:aws-lambda のような）Iconify のもので、ページを公開する側が JavaScript でパックを登録した場所でしか表示されず、GitHub でさえ登録していません。ここで受け入れれば、ほかのどこでも再現しない絵を渡すことになります。align row a b c（または align column）は指定したメンバーを同じ行（または同じ列）に並べます。存在しない名前は、理由を告げずに配置をそのままにするのではなく、行番号を示して図を拒否します。

sankey（sankey-beta）はフロー図を描き、帯の太さがそのまま値になります。本文に矢印は一つもなく、3 列の CSV（始点,終点,値）で 1 行が 1 本のつながりです。同じ名前を両端に書くことで流れがつながります。カンマを含むラベルは引用符で囲み、その中の引用符は二重に書きます（"固定 ""費用"""）。同じ始点と終点の組を繰り返すと合算されます。ノードのバーの高さは、入ってくる量と出ていく量の大きいほうです。受け取るより多く配るノードで、出ていく帯が枠からはみ出さないためです。列は各ノードまでの最長経路から決まり、出口のないノードは最後の列に置かれます。0 以下の値、自分自身へのつながり、循環は、行を示して図を拒否します。循環には最長経路が存在せず、描くためにつながりを切れば、書いていない流れを見せることになるからです。ここに title はありません。本文は純粋な CSV で、受け入れれば LightNote では描けても Mermaid では構文エラーになります。

zenuml は同じ絵のための別の書き方——シーケンス図——で、矢印ではなくコードのように書きます。同期呼び出しは宛先だけを書き（Store.register(item)）、送り手はそれを囲むブロックです。Store.register() { Stock.reserve() } の中で Stock を呼ぶのは Store です。いちばん外側で呼ぶのはスターターで、@Starter(Ana) が名前を与えます。指定しなければ棒人間の User が使われ、呼び出しが必要とするときだけ現れます。非同期メッセージは A->B: テキスト（開いた矢先、誰も待たない）で、A->B.method() は送り手を明示した同期呼び出しです。{} が入れ子になり、return x は囲んでいる呼び出しの呼び手へ戻り（途中の if は関係ありません）、x = A.m() は同じ応答の別の書き方、new A(args) は生成、// コメント は次のメッセージの上のノートになります。ブロックは if/else if/else、while/for/forEach/loop、opt、par、try/catch/finally です。} else { は新しい枠を開かず、同じ枠を仕切りで続けます。@Actor は棒人間を描き、ほかの注釈子（@Database、@Boundary など）はラベルのステレオタイプ（«Database» Stock）になります。ここではそれらのアイコンを描かないからで、名前はそのまま残ります。空白を含む名前は引用符で囲みます。このブロックの行き先に注意してください。Mermaid では zenuml はページが JavaScript で登録しなければならない外部の図で、GitHub はそれをしません。ここで描かれる同じノートが、あちらではコードブロックのまま表示されます。

そして図を読み取れなかったときは、ブロックのすぐ下に理由と行番号が表示されます。まだ描画していない種類では警告は出ません。書いた内容に誤りはないからです。

数式と化学（LaTeX）

数式（LaTeX）

数式（LaTeX）。文中の $E = mc^2$ とブロックの $$…$$ は、読書モード、書き出したファイル、ノートに質問の回答で数式として描画されます。描画はノートのテーマに従います。書式付き編集ではブロックの数式も描画され、その上にブロックバー（編集・コピー・削除）が表示されます。文中の数式も同じように、テキストの行に収まって描画されます。編集するにはダブルクリックするか Ctrl+Enter を押してください。同じバーで開きます。数式の直後で Backspace を押すと $…$ に戻り、その場で編集できます。テキストエディタではすべてテキストのままです。数式を見るには Ctrl+E を使います。まずはノートのバーの挿入 → 数式 (LaTeX)を使ってください。数式はシステムの数式フォント（Windows では Cambria Math）で描かれ、ノート本文のフォントは使いません。数式用のイタリック、テキストフォントにない記号、内容に合わせて伸びる括弧や根号はここから来ます。数式フォントが入っていない場合は、ノートのフォントに戻り、これらの記号は LightNote 自身が描きます。

対応範囲はギリシャ文字、演算子と関係子、指数 ^ と添字 _、\frac、\sqrt（指数付き）、大きさが変わる区切り記号を伴う \left…\right、限界付きの \sum/\prod/\int、立体の関数（\sin、\log など）、\text/\mathrm/\mathbf/\mathbb、\mathcal/\mathfrak/\mathsf/\mathtt/\boldsymbol の各アルファベット、\binom、\overset/\underset、\bmod/\pmod、\big…\Bigg の系列、空白の \,/\quad/\hspace、環境 cases、matrix/pmatrix/bmatrix/vmatrix、aligned、gathered、array（| と \hline も）、\overbrace/\underbrace、\begin{CD}・\begin{tikzcd}（可換図式）、\xrightarrow、\boxed/\cancel、\not、\substack、\|/\middle、\smash、\textcolor/\color（色相はそのまま、明るさはノートのテーマに合わせて調整されます）、\colorbox/\fcolorbox（背景は書いた色のまま、文字は背景に合わせて調整されます）、\tag（式のラベル。式の直後に並びます。align では行ごとに付き、列にそろいます）、\phantom、\displaystyle、中置形の \over/\atop/\choose です。対応範囲はこの一覧だけではありません。比較の変種（\leqslant）、論理（\land、\vDash）、統計の演算子（\argmax）、伸縮する二重矢印（\xRightarrow）、二重括弧（\llbracket）も使えます。旧来の TeX のフォント切替（{\rm d}x、{\bf A}、{\cal L}）やディラック記法（\braket{\phi|\psi}）も使えます。式の中で定義したマクロ（\newcommand、\def）はその式の終わりまで有効で、直接入力した Unicode 記号（x ∈ ℝ）は対応するコマンドと同じに扱われ、\text{…} の中には $…$ で数式を書けます。単独の式は \\ で複数行にできます。$$ ブロック内の \label{eq:name} は閲覧モードで式に番号を付け（{#eq:name} と同じカウンター）、本文の \eqref{eq:name} は括弧付きの番号になります。LaTeX の書き方も使えます。文中の \(…\) とブロックの \[…\] も同じように描かれます（ChatGPT がよく出力する形式です）。描けないものは書いたままのテキストとして表示され続けます。

斜めの矢印を含む可換図式（\begin{tikzcd}）。\begin{CD} は水平と垂直の矢印しか描けませんが、最もよく使われる可換三角形には斜めの矢印が必要です。各対象がセルで（& で区切り、\\ で行を変えます）、矢印はセルの中に書きます：A \arrow[r, "f"] \arrow[rd, "g"'] & B。方向は r/l/u/d の並び（rd が斜め、rr は 2 列分）で、\ar や略記（\rar、\dar、\drar）も同じ矢印です。引用符のラベルは右向きの矢印の上側に出ます。'（または swap）で反対側に移り、名前が図の内側か外側かを決めます。hook（包含）、two heads（全射）、dashed、Rightarrow、equal も使えます。曲線（bend left）とこのサブセットが描けないオプションは名前を示して拒否します——曲がった 2 本の矢印を直線で描けば重なってしまい、1 本しかないと言うことになるからです。

文章中の $ は数式になりません。$5 と $10 の価格は価格のままです。開きの直後に空白は置けず、閉じの直前にも置けず、閉じの直後に文字も置けないからです（PATH=$dir1:$dir2 が数式にならないのはこのためです）。バッククォートで囲んだ $x$ もコードのままです。 描画できなかったときは、その理由が表示されます。$$ ブロックの直下に 1 行、文中の数式では同じ内容につき 1 回だけ、読み取れなかったコマンドや区切り記号を示します。 \(…\) の書き方で貼り付けた数式を $…$ にそろえたい場合は、整形 → 数式を $ に正規化が選択範囲（またはノート全体）を書き換えます。ノートの文字が画面にあるテキストエディタでのみ使えます。

化学：mhchem と SMILES

化学。mhchem の記法も描画されます。\ce{2 H2 + O2 -> 2 H2O} は下付き数字を自動で配置し、-> と <=> は矢印になり（->[\Delta] でラベルを付けられます）、Na+ と SO4^2- は電荷に、(aq) と (l) は立体で詰めて出力され、^{227}_{90}Th は同位体を揃え、v/^ は沈殿と発生した気体を表します。\pu{123 kJ//mol} は単位付きの量を書き、二重スラッシュは分数になります。偏った平衡（<=>> と <<=>）は反応が進みやすい向きの矢印を長く描き、結合の明示（\bond{~}、\bond{~-}、\bond{...}）は教科書と同じように線を重ね、Kröger–Vink 表記（O''_{i,x}、Li^x_{Li}）は有効電荷を上付きに置きます。変数は斜体、元素は立体で出力されます。NO_x の x は変数で、Fe^{II} の II は酸化数です。

LaTeX の構造式（\chemfig）。\ce は化学式を書き、\chemfig{...} は同じ数式の中に骨格を描きます—\chemfig{H_3C-[:30]CH_2-[:-30]OH} はエタノール、\chemfig{*6(-=-=-=)} はベンゼンです。角度は自分で決めます：[:30] は絶対角、[::45] は直前の結合からの相対角、[3] は 8 分の 1 回転単位です。結合は -、=、~ で、立体化学のくさ形は >、<、>:、<:、>|、<| — 細い先端が不斉炭素側につきます。括弧は側鎖をつり下げ、*6(...) は正多角形の環を閉じます（**6(...) は芳香環の円を描きます）。環の頂点から出る結合は、角度を書かなければ環の外側を向きます。元素記号は立体ではなく立体のない正体で出力され、線は文字の手前で止まります。chemfig の出発・到着ノード（[,,1,2]）は理由を示して拒否します：ラベルのどの部分に結合するかを決めるもので、無視すれば別の構造を描いてしまうからです。 縮合環は最初の環の内側に、共有する結合の直後に書きます。内側の環は結合を 1 つ少なく書きます—その辺はすでに描かれているからです。ナフタレンは \chemfig{*6(-=-*6(-=-=-)=-=)} です。

化学構造式 (SMILES)。 ```smiles のブロックに SMILES の 1 行 (CC(=O)Oc1ccccc1C(=O)O) を書くと、読書モード、 書式付き編集、エクスポートしたファイル、ノートに聞く の回答で 骨格構造式として描かれます。\ce と対になる機能で、あちらは 化学式を書き、こちらは分子を描きます。骨格の慣習に従います — 炭素は書かず頂点で表し、ヘテロ原子はテーマのアクセント色で 元素記号を出し、芳香環 (c1ccccc1) には内側の破線の円がつきます。 立体化学は作図されます。[C@H] と [C@@H] はくさびになり（手前に向かう結合は塗りつぶし、奥へ向かう結合は破線、細い先端が立体中心）、F/C=C/F と F/C=C\F は書いたとおりにトランスとシスで描かれます。紙の上で表せないもの（@SP1 などの四面体以外の名前付きの形）は受け付け、画像の中のキャプションが「宣言のみで作図はしていない」と伝えます。1 つのブロックが描くのは 1 つの構造です。行の途中の空白は拒否されます。SMILES では空白が構造の 終わりだからです。読めなかったときは、LightNote がどこがおかしいか（括弧、 環番号、元素）を伝え、コードブロックは書いたままで残ります。まずは、ノートのバーの 挿入 → 構造式 (SMILES) を使ってください。

ノートの中のカレンダー

```calendar のブロックは、ノートの中にカレンダーを描きます。読書モード、書式付き編集、印刷のいずれでも表示されます。画像ではなく本物の表なので、選択してコピーでき（Word や Excel に貼り付けるとセルがそのまま残ります）、Ctrl+F で予定を探せます。1 行目でどのカレンダーかが決まります。月（2026-09）なら月を、日付（2026-09-24）ならその日を含む週を表示し、列が曜日、行が時刻になります。week なら日付のない週を表示します。時間割、日課、当番表などです。続く各行は予定かオプションで、%% で始まる行はコメントです。まずは、ノートのバーの 挿入 → カレンダー（月間、週間、日付なしの週間。例が入った状態で挿入されます）を使うか、/calendar と入力してください。

月。予定は日にちの数字から書き始めます。15: 論文審査 は 1 日を、22-26: 学会 は期間を示し、テキストのない 24: はその日を強調するだけです。期間のテキストは最初の日に表示され、翌週にまたがるときは次の行の先頭にも表示されます。

```calendar
2026-10
15: 論文審査
22-26: 学会
```

週。予定は曜日の名前（mon、tue,thu、mon-fri）から書き始め、時刻を続けます: mon 09:00-10:30: 会議。時刻は 09:00、9h30、または 9 だけでも書けます。時刻がない予定は、いちばん上の終日の行に入ります（fri: 提出）。曜日を名前で書くので、翌週にブロックをコピーしても変えるのは 1 行目だけです。days: mon-fri はリストの順で列を選び、hours: 8-18 は範囲を固定します（省略すると 8 時から 18 時で、予定が収まるように広がります。指定すると、範囲外の予定は拒否されます）。step: 30 は 1 行の分数です。長い予定は最初の行にだけ時刻付きのテキストを書き、続く行は色だけを付けます。

```calendar
2026-10-14
days: mon-fri
mon,wed 09:00-10:30: チームミーティング
tue 14-16: 勉強
tue 16-17: 見直し
fri: プロジェクト提出
```

3 つの形式すべてで、title: はバーのタイトルを置き換え（日付のない週では、指定したときだけバーが表示されます）、week: monday は週を月曜始まりにし（既定はノートの言語に従います。days: があればリストの順が優先されます）、today: no は今日の印を消します。日付のない週では、印は今日の曜日に付きます。隣り合う予定は別の色になり、1 件に見えません。月と曜日の言語はノートの言語（frontmatter の lang キー）で、週末もその言語の慣習に従います。今日の印は画面にだけ表示され、紙や PDF には付きません。読む人は別の日に読むからです。カレンダーを変更するには、その上で Ctrl+Enter を押し、バーでソースを編集します。表はソースから生成されるため、セルに入力しても何も変わりません。バーを開いている間は、入力に合わせて表が作り直されます。バーを閉じると適用され、Ctrl+Z で変更全体を 1 回で元に戻せます。エクスポート（Word、OpenDocument、HTML、LaTeX、GitHub の Markdown）では、タイトル付きの普通の表になります。ソースをカレンダーとして読めないときは、LightNote が行と箇所を伝え、コードブロックは書いたままで残ります。引用やリストの中では、カレンダーは読書モードで表示され、書式付き編集ではコードのままです。

番号付けと相互参照

図にラベルを付けると、読み取りモードで番号付きのキャプションが 付きます。![水の循環](cycle.png){#fig:cycle} は画像のあとに 図 1 — 水の循環 が続きます。表はそのすぐ下、コロンで始まる行に ラベルを書きます（: 採取した試料 {#tbl:samples}）。ブロックの 数式は、閉じる $$ に {#eq:mass} を付けると右の余白に 番号が入ります。 この機能は既定でオフです。設定 → 機能 → 学術 → 番号付けと相互参照で有効にしてください。LightNote は論文も書けるシンプルなエディターです。学術的な文章を書かない人が、使わないメニューや設定でその代金を払うべきではありません。-numeracao

あとは指すだけです。@fig:cycle は図 1に、 [@fig:cycle] は（図 1）に、-@fig:cycle は 番号だけになります。引用と同じ文法なのは意図的です。途中に図を入れても、 全部が自動で番号を振り直します —— 数えるのは文書で、読む順にです。

番号付けはラベルによる任意です。{#fig:…} のない画像は 今までどおりのままです。そして存在しないラベルは書いたとおりに残ります。 引用と同じで、参照が壊れている合図になります。

節番号（ABNT NBR 6024）: ノートのプロパティに section-numbers: true を書くと、見出しに番号 —— 1、 1.1、1.1.1 —— が付きます。左寄せ、空白ひとつ区切り、末尾の点は なしです。{#sec:method} を付けた見出しは @sec:method で指せます。番号付けがないときは、参照はその節の 見出しになります。

行に [list of figures] や [list of tables] だけを 置くと、[TOC] が目次を作るのと同じように、規格が求める一覧が できます。これらはすべて読み取りモード（と書き出した PDF/HTML）の ものです。エディターではファイルに書いたものが残り、だからこそノートに 触らずに番号を振り直せます。

引用と参考文献

本文中の引用は [@キー] と書きます。キーは、その文献があなたの 参考文献に持っている名前です。@ を打つと LightNote が知っている 文献を著者・年・タイトルつきで提案し、ノートに入るのはキーだけです。 [@キー, p. 45]（ページつき）、[-@キー]（著者名がすでに 文の中にあるとき）、[@a; @b]（複数の文献をまとめて）も使えます。 この機能は既定でオフです。設定 → 機能 → 学術 → 引用と書誌で有効にしてください。LightNote は論文も書けるシンプルなエディターです。学術的な文章を書かない人が、使わないメニューや設定でその代金を払うべきではありません。-citacoes

読み取りモードでは引用が整形された文になります — (Silva, 2020, p. 45) —。行に [bibliography] だけを置くと、引用した 文献の一覧が、その書式が求める順で現れます。エディターではキーがそのまま 見えます。あなたが編集するのはキーだからです。

書誌はワークスペースの中のファイルです。フォルダーにある .bib、.ris、.csl.json はすべて対象です。 だからこそ Git や USB メモリーでノートと一緒に持ち運べ、別のパソコンでもその まま使えます。これらのファイルを開くと、文献の一覧が各キーつきで表示され、 そのままコピーできます。

文献を取り込むには: ツール → 書誌 → DOI で文献を追加は DOI か arXiv の識別子から残りを自動で取得します。Zotero から取り込むは、この パソコンで動いている Zotero 7 のライブラリを読みます（先に設定 → 詳細 → このコンピューターの他のアプリケーションとの通信を許可するをオンに）。

書式はフォルダーのもので、ノートが上書きできます。既定はツール → ワークスペースの設定 → 引用で選びます（ABNT、APA 7、バンクーバー方式）。 別の提出先に向けたノートは、プロパティに citation-style: apa と 書きます。参考文献にないキーは書いたそのまま残るので、どれを直せばよいか すぐ分かります。

コネクショングラフ

ツール › コネクショングラフ（Ctrl+Alt+G）は、ワークスペースの すべてのノートをインタラクティブなグラフとして表示します。各ノードは .md ノート、各線はウィキリンクです。ノードは自動的に配置され（物理アニメーション）、 ドラッグできます。ホバーすると隣接ノードが強調され、他は淡くなります。 クリックでノートが開きます。スクロールでズーム（近づくと名前が表示）、 背景をドラッグでパンします。

タブのツールバー: 名前で絞り込み（一致しないノートを淡色表示）、 孤立ノート（リンクのないノート。グレー表示）の切り替え、力のスライダー （反発・距離・重力）、グラフをウィンドウに合わせる、ノートの再スキャン。 接続が多いノートほどノードが大きくなり、第 1 階層のフォルダーごとに色が付きます。

似ているノート。ノートの中にあるつながりのミニバーは、入ってくるリンク、出ていくリンク、名前による言及を並べます。その末尾に似ているノートがあります。リンクも共通の語もなくても、近い話題を扱っているノートです。ノートを切り替えるたびではなく、頼んだときに計算します（計算するをクリック）。索引をたどるのはディスクの読み取りだからです。各行には名前、どれくらい近いか、そして提案のもとになった抜粋が出ます。この根拠がなければ、良し悪しを判断しようがありません。AI 呼び出しは使いません。すでにある意味の索引を使うので、このセクションは 設定 → 一般 → 機能 で意味による補強（埋め込み）を有効にしている場合にだけ現れます。

テーブル（Parquet・CSV・JSON・Excel）

開く・問い合わせる

.parquet ファイルはテーブルとして開きます。.csv、 .tsv、.json はテキストとして開き、ツリーのコンテキストメニューに テーブルとして開くがあります。読み込みは DuckDB 経由でページングされ （オンデマンド）、並べ替え（ヘッダーをクリック）と絞り込みはエンジンに 委ねられます。構造ボタンは列・型・行数を、Parquet では行グループと圧縮も表示します。 ビューは読み取り専用です。

テーブル上部の自由 SQL バーは任意の DuckDB クエリを受け付けます。 ビュー t は開いているファイルを表します。ツリーのフォルダーの コンテキストメニューからフォルダーをテーブルとして開くを選ぶと、同じ形式の すべてのファイルを 1 つのテーブルとして読み込みます。テーブルのメニューから現在のビューを エクスポート（CSV/Parquet/JSON）でき、ツリーのメニューから表形式ファイルを別の形式に 変換できます。自由形式の SQL はコマンドラインの query コマンドや MCP でも利用できます。

Excel スプレッドシート（.xlsx）は、シートセレクター付きの 読み取り専用テーブルとして開きます。軽量なリーダーで、Excel のインストールは不要です。

Excel のシート

ファイルに忠実。シートはファイル自身の書式で表示されます。数値・通貨・ パーセント・日付は Excel で設定された書式に従い、3750.5 として保存された値に 通貨書式が付いていれば ¥3,750.50 と表示され、パーセントは 0.15 ではなく 15% になります。フォント（名前・サイズ・太字・斜体・下線）、文字色、 塗りつぶしの色、セルごとの罫線、配置、折り返し、インデント、回転した文字列、列幅も ファイルから読み取ります。数値は右、文字列は左に揃います（Excel と同じ）。

シートが独自の色を持つ場合、グリッドは白い背景の上に描画されます。Excel の配色は 白い紙を前提に選ばれており、ダークテーマの上では読めなくなるためです。書式がまったくない ファイルは、これまでどおり LightNote のテーマに従います。シートは書かれた順序のまま 開きます。見出しをクリックすれば、他の表と同じように並べ替えられます。

元のレイアウトとズーム。シートがセルの結合や独自の行の高さを使っている場合、あるいは グリッド線を隠している場合、タブは元のレイアウトモード（バーのボタン）で開き、その配置を Excel と同じように再現します。このモードが決めるのは配置だけで、色・フォント・罫線・表示形式は どちらのモードでも有効です。オンの間は並べ替えと絞り込みが使えません。並べ替えると結合された 帯が別の行に残ってしまうためです。並べ替えたいときはボタンをオフにしてください。どれも使っていない シートは通常モードで開きます。ズームはすべてのビューと同じで、ステータスバーにあります（ワークスペースとウィンドウを参照）。グリッドの上でも Ctrl+マウスホイールが使えます。Excel の テーブルとして書式設定されたシートにも色が付きます。テーブルのスタイルは Excel に内蔵されていて ファイルには入らないため、見出しと縞模様はテーマから復元します。

コピー・絞り込み・グラフ

形式を指定してコピー。 LightNote のどの表（Parquet/CSV/JSON、Excel、SQL の結果、タスク、ベース）でも、右クリックメニューの 形式を指定してコピー で選択範囲を整形済みでクリップボードに入れられます。書式付きテーブル (Teams、Outlook…) は、リッチテキストを解釈するプログラム（Teams、Outlook、Word、Excel）に、罫線と見出しの付いた本物の表として貼り付きます（リッチテキストがない場合は自動的に TSV になります）。ほかはテキストとして貼り付きます: Markdown 表（ノートにそのまま）、CSV（RFC 4180 に沿った引用符）、TSV（タブ区切り）、HTML（<table> のマークアップ）、JSON、JSONL（1 行 1 レコード）、YAML、そして コード サブメニュー — ソースファイルに貼り付けられるリテラルを生成します: Python（辞書のリスト）または JavaScript / TypeScript（オブジェクトの配列）。JSON・YAML・コードでは数値のセルは引用符なしで出力されますが、元のテキストは保持されるため 007 のような ID は文字列のままです。Ctrl+C は従来どおり TSV でコピーします。

すべての表が同じ操作感になりました。 Ctrl+F で クイックフィルター（「いずれかの列に含む」）にフォーカスし、カウンターが残り行数を表示し、CSV への エクスポート があります — .xlsx のシート、タスク、ベース でも同様です。グリッドの右クリックメニューには引き続き 形式を指定してコピーがあります。

結果のグラフ。テーブルのサイドバーに グラフ ボタン（棒・折れ線・散布図）があります。集計は DuckDB で実行され（生の行は取得しません）、本日のノートに追加 ボタンでグラフを画像として保存できます。構造 パネルには 列ごとのプロファイル（数値列のミニヒストグラムと、その他の列の最頻値）も含まれます。

複数のグラフとピボットテーブル。 2 つのフィールドを掛け合わせて 3 つ目を集約したいとき、また 1 つのテーブルに複数のグラフを残したいときは 分析エリア を参照してください。

分析エリア: ピボットテーブルと複数のグラフ

グラフと統計

テーブルのタブには 2 つのモードがあり、バーの データ と 分析 のボタンで切り替えます。データ はいつものテーブル、分析 は同じソースに対する グラフ と ピボットテーブル を好きなだけ並べておけるボードです。各項目はカードになっており、編集できるタイトル、選択欄を表示する歯車ボタン、⋮ メニュー（移動・複製・削除）が付いています。

本物の統計。棒・折れ線・散布図に加えて、グラフは箱ひげ図も描きます。カテゴリごとに四分位の箱、太い線の中央値、そしてテューキーの柵（1,5 × IQR）に置いたひげ — 最小値・最大値ではありません。列の平均には、誤差の選択でばらつきのひげが付きます: ± 標準偏差（データそのものを表す）、± 標準誤差、± 95% 信頼区間（平均の精度を表す）。三つとも平均を選んだときだけ現れます。「合計 ± 偏差」には意味がないからです。Y 軸を対数のチェックは、桁が大きく変わるデータのために対数目盛にします。値に 0 か負があるときは断りを添えて無視されます — そこには対数がなく、その点を黙って捨てるとグラフが嘘をつくからです。散布図では近似直線が R² 付きの回帰直線を描きます。これは画面に出ている標本ではなく、データベース側で全行を使って当てはめたものです。図の下には、選んだ列の記述統計の一行（n・平均・偏差・95% 信頼区間・最小・四分位・中央値・最大）が出ます。これは独立した問い合わせです: 棒から計算すると「平均の平均」になり、それが本当の平均と一致するのは、どのグループも同じ大きさのときだけだからです。

ピボットテーブルと合計

ピボットテーブル。 行 と 列 に置くフィールド（各軸に複数を入れ子にでき、ドラッグで階層の順序を変えられます）、値 のフィールド、そしてその集約方法（合計・件数・一意の件数・平均・最小・最大）を選びます。値のフィールドを選ばない場合は行数を数えます。テーブルの横のミニバーにも、グラフの隣にあります。データを離れずに素早く確認できます。

集約はデータベース側で実行され、すでに縮約された結果だけが返ります。生の行が上がってこないため、数千万行の Parquet でも扱えます。クエリは標準 SQL なので、ピボットテーブルは SQL クライアントの すべて のデータベース（SQLite・DuckDB・PostgreSQL・MySQL・SQL Server・Oracle）で使えます。グラフのように DuckDB だけ、ということはありません。

合計。 行の合計 と 列の合計 のチェックで、締めの行と列が加わります。平均 では合計は 加重平均 です。平均の平均ではありません（グループの大きさが違うと誤りになります）。一意の件数 は合計できないため（異なる集合の和は各部分の合計からは求められません）、そこではチェックが無効になり、理由がツールチップに出ます。誤った数値を見せることはありません。

保存先・CSV・グループ化

分析の保存先。 データファイルの隣にある JSON（sales.parquet → sales.parquet.analysis.json）です。開かれた形式なので、データと一緒に Git に入り、同僚にもそのまま渡せます。分析ファイル ボタンでその JSON をタブで開けます。分析を空にするとファイルは削除されます。テーブルとして開いたフォルダー全体には固有のパスがないため、その分析は保存されません（ボタンがその旨を示します）。各カードには 本日のノートに追加 もあります。グラフは画像として、ピボットテーブルは Markdown の表 として入るので、ノートの中でもコピーや編集ができるテキストのままです。

CSV は操作ひとつ、区切り文字を誤ったときの逃げ道つき。 テーブルとして開く は DuckDB で開き、自由な SQL・グラフ・ピボットテーブル・分析エリアが使えます。区切り文字が認識されないことがあり（列数がそろっていない行があると起こりがちです）、その場合テーブルは 1 列だけになり、行がまるごとその中に入ります。そのときはテーブルの上に帯が出て、ファイルが持っていそうな列数を示し、寛容な読み取りを提案します。これは列数がそろっていなくても 1 行ずつ読む方式で、検索と AI が使っているのと同じ読み取りです。絞り込みと並べ替えはできますが、自由な SQL・グラフ・ピボットテーブルはありません。まだ保存していないテキストや、区切り文字を自分で指定したい場合は 表示 → 区切りファイルとして表示… を使います。

パターンでグループ化。 日付やコードの列では、異なる値の数が行数とほとんど変わらず、値ごとに集計しても何も見えてきません。パターンマスク は英字を A、数字を N に置き換え、それ以外はそのまま残します（2027/10/10 → NNNN/NN/NN）。これで数百万行が 2 つか 3 つの形にまとまり、そこから外れたものがまさに汚れたデータです（10-10-2027 で入ってきた日付、接頭辞が欠けたコード）。グラフでは X 軸の隣にある パターン のチェック、ピボットテーブルではフィールドのピルを右クリック（フィールドごとなので、コードの形と通常の項目を掛け合わせられます）、構造 パネルでは各列の最頻値の下に最頻パターンが並びます。計算はデータベース側で実行されます。SQLite と汎用 ODBC ではマスクが使う文字列関数がないため、理由付きで無効になります。

PDF と画像

.pdf ファイルはネイティブのビューアー（Qt6::Pdf、重い依存関係なし）で開きます。描画は CPU で行われ、WebEngine は使いません。画像は画像ビューで、アニメーション GIF はアニメーションビューで再生されます。

タブのツールバーには 6 つのサイドパネルがあり、一度に 1 つ表示されます。目次（ファイル自体に保存された目次。PDF に目次がない場合、ボタンは無効になり理由が表示されます）、サムネイル（スクロールに合わせて描画されるページ一覧）、検索、リンク、プロパティ（タイトル、作成者、日時、ページとファイルのサイズ）、ハイライト（あなたがハイライトした箇所を読む順に並べたもの）です。

検索（Ctrl+F）は文書全体を対象にします。一致した箇所はページ上で強調され、前後の文とともに一覧に並びます。F3 / Shift+F3 で次と前へ移動できます。走査は順次行われるため、文書をたどる間に一覧が増えていきます。

ページ入力欄は番号と印刷上のページ番号のどちらも受け付けます。前付けがローマ数字で振られた文書では、1 と入力すると 1 枚目ではなく印刷された「1」ページに移動します。ページ表示モードのボタンで、連続スクロールと 1 ページずつを切り替えられます。

パスワードで保護された PDF は開くときにパスワードを尋ねます（最大 3 回）。取り消した場合はタブが開かないだけです。同じ実行中は再び尋ねられません。アプリは放置されたタブを解放したあと自分で開き直すため、そのままでは自分で手間を作ることになるからです。入力欄の 「このファイルのパスワードを記憶する」 にチェックすると、次回以降の起動でも有効になります。パスワードは Windows によって保護され（このマシンのあなただけ）、Git にもクラウドにも送られず、設定のエクスポートにも含まれません。すべて削除するには 設定 → 機能 → PDF のパスワード。保護された PDF は起動時に自動では開き直されません。ウィンドウを表示する前にパスワードの要求が並ぶより、あなたが開くのを待ちます。

ツールバーの操作メニューから、ページのテキストのコピー、文書全体のテキストのエクスポート、ページの画像としてのコピーや保存、そしてページを今日のノートへ送ることができます。リンクパネルがあるのは、Qt の PDF 部品が内部リンクは自動でたどる一方、外部リンクは無視するためです。ウェブアドレスは確認のうえ、このパネルから開きます。

ハイライトする。ハイライトボタンで蛍光ペンをオンにし、ページの文字の上をドラッグすると、その箇所がハイライトされます。隣の矢印で色を選べます。ハイライトは矩形ではなく文字に結び付きます。だからズームやページ表示を変えてもずれず、逆に文字の層がないスキャン PDF では使えません（その場合は何も起きないのではなく、その旨が表示されます）。ハイライトパネルではクリックでそのページへ飛び、右クリックのメニューでメモを付ける・引用箇所をコピーする・削除するができます。ツールバーのアクションメニューにあるハイライトをコピーとハイライトをノートとして保存…は、読書ノートを Markdown で書き出します。各箇所は引用になり、ページごとに PDF のその位置を開くリンクが付きます（ronbun.pdf#page=12）。その代償: ハイライトは PDF の隣のファイル（ronbun.pdf.highlights.json。読めるテキストで、Git で版管理できます）に保存され、PDF の中には入りません。つまり LightNote では見えますが、ほかの PDF ビューアーでは見えません。ファイルが別の版に差し替えられた場合、居場所を失ったハイライトは、間違った文の上に塗られるのではなく、そのように印が付きます。

制限: 蛍光ペン以外では、マウスでのテキスト選択はできません。Qt の PDF 部品がその機能を提供していないためです。内容を持ち出すには「このページのテキストをコピー」、文書のエクスポート、またはハイライトそのものを使ってください。

画像：スクリーンショットに注釈を付ける

ツール

画像は独自のツールバーを持つタブで開きます。回転・反転・拡大のほかに注釈ツールを備えており、スクリーンショットを撮り、要点を示し、そのままドキュメントへ持っていくまでの道のりをまかないます。 始めるのにスクリーンショットは要りません。新規 → 新しい空白の画像で、印の付いたフォルダーに白い .png の紙が作られ、ペンを持った状態で開きます —— 画像を開いたときの既定である「移動」は、ここでは動かすものがありません。

最初のツールは移動です。ドラッグはこれまでどおり画像を動かします。選択は一部を選びます — ドラッグで作成し、内側をドラッグして動かし、四隅と辺のハンドルでサイズを変えます。Esc で選択を解除し、Del でその範囲の中身を消します。移動モードでは Shift+ドラッグ でも選択できます。どのツールでも、マウスの中ボタンで画像を動かせます。

スポイトは画像そのものから色を取ります。左ボタンは枠線の色に、右ボタンは塗りつぶしの色になります。注釈を描いたあとの画像から読むので、いま付けた注釈と同じ色を繰り返すのにも使えます。

残りは描画用です：四角形、楕円、矢印、線、ハイライト（蛍光ペンのような半透明）、ペン（フリーハンド）、ブラシ、番号付きステップ（1, 2, 3... と自動で採番されます）、テキスト、ぼかし、スポット（選んだ領域以外を暗くします）。描画中に Shift を押すと正方形・正円と45度の角度に固定されます。

色・太さ・ぼかし

色は2つで、ボタンも2つです。枠線の色（線とラベルの色でもあります）と塗りつぶしの色で、後者はなしにもできます。塗りつぶしがないと四角形と楕円は輪郭だけになり、番号付きステップとテキストは枠線の色を背景にして、ラベルは白か黒 — 対比の出るほう — で描かれます。塗りつぶしを選ぶと、それが図形の内側とラベルの背景になり、枠線の色が文字の色になります。

ブラシは塗りつぶしの色で、線の太さと同じ大きさの点を描きます。丸か四角かは太さの隣のボタンで切り替えます。1回のクリックでも点が残ります。塗りつぶしを白にすれば消しゴムになり、下にあるものを覆い隠せます。

太さは線、ラベルの大きさ、そしてぼかしのブロックの大きさに効きます。関係のないツールでは淡く表示されます。色と太さはセッションをまたいで記憶されます。Ctrl+Z と Ctrl+Y で注釈を元に戻したりやり直したりでき、注釈をすべて消すは一度に全部を消します（これも元に戻せます）。

ぼかしは隠すためのものです（トークン、メールアドレス、パスなど）。タブが開いている間は元に戻せますが、保存またはコピーすると、その領域のピクセルは本当に破壊されます。出ていくファイルは元の内容をどこにも残しません。

切り取り・貼り付け・回転・キャプチャ

名前の似た3つの操作が、それぞれ違うことをします。切り取り（Ctrl+X）は選択範囲をクリップボードにコピーし、その領域を消します。消えたところは塗りつぶしの色（設定がなければ白）で塗られます。選択はそのまま残るので、続けて貼り付けを行うと、切り取った部分がもとの位置にそのまま浮いた状態で戻ります — これが画像の一部を動かすやり方です。Del はコピーしない切り取りです。いっぽう画像メニューの選択範囲だけを残すは逆で、その領域を残して他を捨て、画像の大きさを変えます。

残りの仲間：コピーは注釈付きの画像、または選択範囲だけを持ち出します。貼り付けはクリップボードの画像を浮いた状態で持ち込みます — 同じハンドルで移動やサイズ変更をして、外側をクリック（または Enter）すると確定し、Esc で破棄されます。Ctrl+A（または Ctrl+T）で画像全体を選択できます。ほかに保存（注釈をファイル自体に書き込みます）、名前を付けて保存...、今日のノートに送る（PNG を Anexos/ に保存し、ノートに ![]() を挿入します）があります。未保存の注釈があるあいだタブにはアスタリスクが付き、閉じるときに保存するかどうか尋ねられます。

画像ボタンには、図全体に効くものがまとまっています：回転、反転、パーセント指定のサイズ変更、幅 1600 / 1200 / 800 px に縮小（スクリーンショットはドキュメントには大きすぎる大きさで生まれます）、単色の余白を切り落とす、余白を追加、ドロップシャドウ、そして注釈を画像に焼き込む。最後のものは注釈をその場でピクセルに変え、注釈の上からぼかせるようにします。サイズ変更は注釈と線の太さも一緒に連れていきます。

LightNote を離れずに画面を撮るには、通知領域のメニューの画面をキャプチャ...（または Ctrl+Alt+P）を使います。デスクトップが静止し、ドラッグで範囲を選ぶと（Esc で中止）、切り抜きが新しいタブで開き、すぐ注釈を付けられます。

制限：いちど描いた注釈は移動も編集もできません — Ctrl+Z で取り消して描き直してください。アニメーション GIF と WebP はアニメーション表示で開くため注釈は付けられません。また .svg は読み込み時にラスタライズされるので、保存では PNG の保存先を尋ねます。

HTML ページ（.html）

ツリーから開いた .html は、本物のレイアウトエンジンを備えたプレビュータブになります。フレックスボックス、フロート、配置、メディアクエリ、グラデーション、CSS 変数、CSS3 セレクターに対応します。AI が生成するような指標カード・表・グラフのある最近のレポートが、文字の壁にならずブラウザーと同じように表示されるのはこのためです。

テキストは選択できます。ドラッグで選択、ダブルクリックで単語、Ctrl+A でページ全体、Ctrl+C でコピーです（右クリックメニューにコピーとすべて選択があります）。

上部のバーには目次（ページの見出し。クリックで移動）と検索（Ctrl+F。すべての一致を強調し、F3 と Shift+F3 で移動、Esc で閉じる）があります。ズームはタブのバーから移動し、すべてのビューと同じくステータスバーの一か所にまとまりました（ワークスペースとウィンドウを参照）。

PDF に書き出しは A4 でページ分割し、テキストはベクターのまま出力します。PDF は検索でき、テキストも選択できます。タブはディスク上のファイルにも追随します。レポートを作り直せば、読んでいた位置を保ったまま自動で更新されます。さらに、自分で色を指定していないページはアプリのテーマに従い、色を指定しているページは設計どおりに表示されます。

リンクも動きます。同じフォルダーの別のファイルへのリンクはその場で開き、#アンカー はその見出しまでスクロールし、ウェブアドレスはブラウザーで開きます。

できないのは JavaScript とネットワークです。何もダウンロードしません。ページがそれらに依存する場合（スクリプト、<canvas>、<iframe>、外部リソース）は、ブラウザーで開くの帯が出ます。レポートのこつ: AI には JavaScript と CDN を使わない HTML を、グラフは埋め込み SVG で頼んでください。そうすればここで完全に開きます。

それでも、スクリプトを実行することなくクリックに反応するものがいくつかあります。<details> のボックスは見出しで開閉でき（ページにボックスがあるとツールバーにすべて展開が現れます）、タブの並びは表示するパネルを切り替え、表の見出しをクリックすると行を並べ替えます。同じ列をもう一度クリックすると逆順になり、数値の列は文字列ではなく値の順に並びます。タブとパネルの対応が明確でない場合は何も変更されず、ページはそのまま表示されます。

respondem ao clique

エンジンにない 2 つは自動で置き換えます。display:grid と gap は同等のフレックスボックスになり、埋め込みの <svg> は描画されます。box-shadow は無視されます。以前のビューアーに戻すには、設定 → 全般 → 機能の完全なレイアウトの HTML ビューアーのチェックを外します。

印刷

ファイル → 印刷…（Ctrl+P）でページ分割されたプレビューが開きます。余白、改ページ、ページ番号まで、実際に出力されるとおりの用紙が表示されます。印刷ボタンはその中にあり、ズーム、ページ送り、用紙設定と並んでいます。印刷できるのはノート、コード、HTML ページ、画像、開いている PDF です。ほかの画面では項目がグレーのままになり、理由が表示されます。 同じボタンは各画面のツールバーにもあります。ノートではエクスポートの隣に、コード・PDF・画像・HTML ページではそれぞれのツールバーにあります。

用紙に出るのは閲覧モードで見えるものと同じです。トランスクルージョンは解決済み、図番号はそのまま、非公開コメント（%%…%%）は除かれます。コンテンツのテーマが暗い場合でも用紙は白で出ます。真っ黒なページはインクを浪費し、人に渡す文書としても不自然だからです。余白は左右 20 mm、上下 15 mm で、フッターにはページ X / Y が入ります。プレビューの余白ボタンは、文書の余白とプリンターが対応できる最小値を切り替えます。PDF と画像では最小値から始まります。ファイル自体がすでに余白を持っているからです。その隣のテーマは印刷物の色を切り替えます。既定は自動で、暗いテーマを白い紙に変えるのがこれです。一覧にはカタログと自分の明るいテーマが並びます。Dracula Dark で読んでいる人は Dracula Light で印刷できます。紙のために作られた同じ配色です。暗いテーマは用紙全体を塗りつぶしてしまうため対象外です。 すでに使っているテーマには一覧で（使用中）と付きます。選んでも用紙は変わりません。

コードでは構文が白い用紙の上に色付きで出力され、行番号が余白に入ります。長い行は折り返され、切り捨てられません。紙には横スクロールがなく、余白を超えた部分には手が届かないからです。画像は描いた注釈ごと出力され、小さな画像は拡大されません — 元のサイズのまま、用紙の中央に配置されます。GIF は表示中のコマを印刷します。

LightNote から PDF を印刷するとページはラスタライズされ、ハイライトも一緒に出ます。組版の品質を最優先するなら、テキストがベクターのまま残るシステムの PDF ビューアーから印刷してください。PDF への書き出し（ファイル → ノートを書き出し）は別の機能で、これまでどおりです。ページ番号や文書用の余白をファイルにも入れたい場合は オプション付きで書き出し… の 2 つのチェックを入れます。既に書き出している人の PDF を変えないよう、初期状態ではオフです。非常に長い文書ではプレビューが省略されます。プレビューはすべてのページを一度にメモリに保持するためです。アプリはこの制限のない印刷ダイアログへ直接進みます。

フォルダーとしての Zip（.zip）

.zip は専用タブで開きます。左にメンバーのツリー（名前・サイズ・日付）、 右に選択したメンバーの内容（テキスト/コード、Markdown（描画付き）、画像、PDF）が、 ディスクに何も展開せずメモリ上で開きます。テキストと Markdown は編集でき、 Ctrl+S で .zip 内のメンバーを書き換えます。

同じタブで .7z・.rar・.tar（.tar.gz、.tar.bz2、.tar.xz を含む）、.cab、.iso も開けます。これらは読み取り専用で、閲覧・表示・メンバーの取り出しはできますが編集はできません。書き込めるのは .zip だけです。安全に書き直せる形式がそれだけだからです（.rar は独自形式で、自由なライブラリでも圧縮できません）。

画像と PDF は読み取り専用です。非常に大きいメンバー（および .parquet）は 展開先…のみ提供します。メンバーの作成・名前変更・削除には対応していません。

パスワードで保護されたメンバーも通常どおり読めます。開くときに LightNote がパスワードを尋ね（最大 3 回）、「このファイルのパスワードを記憶する」にチェックすると再び尋ねません（既定では同じ実行中、チェックすれば次回以降も。Windows が保護し、このマシンのあなただけが使えます。すべての削除は設定 → 機能）。PDF との形式上の違いに注意してください。.zip の暗号化はメンバー単位で、目次は平文のまま残るため、パスワードがなくてもファイル一覧はすべて見えます。保護されるのは中身だけです。暗号化されたメンバーを含む .zip は起動時に自動では開き直されません。

zip-password

ブロック（.lnb）

ブロックバンドルは、名前が .lnb で終わるフォルダーで、ツリーでは 1 つの項目として扱われます（ダブルクリックで開く）。各ブロックはディスク上の実ファイルで、 順序はバンドルのルートにある blocks.json に保存されます。コードやテキストの セルを積み重ねた、ノートブックのように動作します。 Jupyter のノートブックはここから入ります。ツリーの .ipynb を右クリックしてブロックとして取り込む (.lnb)を選びます。セルの一つ一つが本物のファイルになり —— バージョン管理も検索もできます ——、.ipynb は元の場所に残ります。取り込みは変換ではないからです。ノートブックに保存された出力は来ません。ここでセルを実行すれば、時刻とコマンドつきの本物の結果ができます。

各セルには名前、種類ボタン（インタープリター/レクサーを設定）、コピー・挿入・削除・ 実行のボタンがあります。ここまで実行は、現在のセルまでのコードセルを順に実行します。 出力（stdout+stderr）はセルのすぐ下のパネルに表示されます。ツリー（新規）または ファイル → 新規から作成できます。

Ctrl+Enter はフォーカスのあるセルを実行します — SQL エディタと同じ操作です。

結果は保存されます（実験ノートのように）。実行が終わると、各実行はバンドル内の saida/<セル>/ にある .md ファイルになります — 実行時刻、 終了コード、所要時間、コマンド、そして出力そのものを含みます。Markdown なので、どのエディターでも 読め、ノートブックと一緒に Git で版管理でき、AI チャットからも 見つかります。バンドルを開き直すと、パネルの上に最後の実行の帯が戻ります。クリックすると、 再実行せずに結果を確認できます。

履歴：その帯の隣にある履歴ボタンは、そのセルの過去の実行（実行時刻と終了コード）を 一覧します — 同じセルが時間とともに何を返したかを比較するのに便利です。セルごとに最新 10 件を 保持します。変更するには、バンドルの blocks.json の historyLimit キーを 編集してください（0 で保存を無効化）。非常に大きな出力は切り詰められます（ファイルに truncated: true と記録されます）。セルの名前変更や種類の変更では履歴も一緒に移動し、 セルを削除すると履歴はごみ箱に送られます。

実際のデータベースに対する SQL セル：上部の帯（接続を選択…）からノートブックに .lnc 接続を指定すると、sql 型のセルはインタープリターではなく データベース上で実行されるようになります。SELECT の結果は出力ファイル内の 表になり（本物の Markdown なので、どのビューアーでも整形して表示されます）、 INSERT/UPDATE などは変更行数を報告します。データベースのエラーはスクリプトを 中断し、失敗した文を記録します。1 クエリあたり最大 100 行を取得します（それ以上あった場合は ファイルに記されます）——結果はテーブルの複製ではなく、あくまで記録です。

接続は blocks.json に相対パスとして保存されるので、フォルダーを移動・同期しても ノートブックは動き続けます。自己完結したノートブックにしたい場合は、.lnc 自体をバンドル内に 置いてください。設定として扱われ、セルにはなりません。データベースタブと同じ接続なので、 一方で接続すればもう一方にも反映され、パスワードはセキュアフレーズの規則に従います。 接続を指定していなければ、sql セルはこれまでどおり設定済みのインタープリターで実行されます。

タスク（カンバン / ガント）

タスクバンドル（.lnt）は、カンバン（ステータス列、カードをドラッグ）、 ガント（工数ベースのスケジュール）、カレンダービューを備えたタスクボードを開きます。 各タスクにはタイトル、列（ステータス）、時間単位の工数、関連する .md ノートを 持たせられます。タスクは MCP と CLI 経由で AI からも 扱えます（作成・移動・更新・ノートの読み書き）。

タスクのノートは、ほかのノートと同じノートです。 埋め込みパネルは .md ノートと同じ画面になりました。Ctrl+E でテキストエディター・読書・書式付き編集を切り替えられ、ノートのテーマ、アウトライン、プロパティも使えます。自動保存もそのままで、タスクを切り替えたりタブを閉じたりしたときに、書式付きモードで入力したばかりの内容も保存されます。ノートを独立したタブで開いたときも、テキストエディターを強制せず、表示の設定に従います。

タスクごとのフィールド: ステータスと工数のほか、各タスクには優先度 （カードの枠を色付けし、テーブルを並べ替え）、期限（超過すると赤いチップ）、 複数のタグ、サブタスクのチェックリスト（カードに進捗バッジ）、 繰り返し（繰り返しタスクを完了すると次の回が生成される）があります。 コンテキストメニュー（テーブル/カンバン）とプロパティパネルで編集します。

キャプチャとリスト: トレイのクイックタスクは自然言語を理解します （例: Pay bill tomorrow 5pm #home !high。日付・時刻・優先度を表す語は英語と ポルトガル語で認識されます）。テンプレートボタンはタスク テンプレートを保存/適用します。期限リストは今日/今後 7 日/期限超過で 絞り込みます。保存したビューはフィルターと並べ替えを保持します。トレイ/ランチャーは 今日が期限または期限超過のタスクのリマインダーを表示します。

カンバンボード: 列をステータス・優先度・タグでグループ化したり、 スイムレーンを作成したり、列ごとに WIP 制限を設定したり（超過するとヘッダーが 赤くなる）、カードを並べ替えたりできます。Linear 風のキーボード操作: ←/→ でフォーカス移動、Ctrl+←/→ でカード移動、N で作成、Space で完了/再開、 Delete で削除。カレンダービュー（期限別）もあります。

埋め込みノート: タスクを選ぶと、ビューの横にその .md ノートが 表示されます（タスク切り替え時に自動保存）。ノートボタンでエディターを切り替え、 ノートをタブで開くで専用タブに開きます。タスクをアーカイブするとすべての ビューから隠れます。アーカイブ済みを表示の切り替えでアーカイブ済み（淡色）が 表示されます。

タスクの設定で 完了したタスクを N 日後にアーカイブ を設定できます。ボードを開いたとき、最終列にそれより長くとどまっているタスクは自動的にアーカイブされます（0 = 無効）。

ノートは既定で埋め込み表示され（タスクをダブルクリック）、入力中に自動保存されます。タスクは閉じるときに「保存しますか?」と尋ねません。ノート内でも AI 操作（Ctrl+K / Ctrl+I）が使えます。

タブのツールバー。 選択したタスクに依存する操作（削除、依存関係、履歴 (Git)）と CSV エクスポート は ⋮ ボタンにまとまりました。ビュー ボタンには期限別リスト、保存したビュー、アーカイブ済みを表示 が入っています（いずれも テーブル に作用します）。Ctrl+F でクイックフィルターにフォーカスし、右側のカウンターが絞り込み後の件数を表示します。

カスタムテーブル（.lnd）

カスタムテーブル（.lnd、ファイル → 新規）は、あなたの 小さなデータベースです。列を実行時に定義し（テキスト・数値・日付・色付き固定リスト・ パス・タグ・パスワード）、スプレッドシートのように行を入力します。並べ替えと 絞り込みもできます。パスフィールドは行をツリーにまとめます （例: 自宅/オフィス）。

パスワードセルはセキュアフレーズで個別に暗号化され、 必要なときに表示されます。タスクと同様に、バンドルは Git に適したテキスト（NDJSON）として 保存されるため、バージョン管理し、複数のマシン間でマージできます。

テキスト列では、セルを開くと浮動の複数行エディターが表示されます。 Enter で改行、Ctrl+Enter で確定します。グリッドではテキストは 1 行で表示され （… 付き）、完全な内容はツールチップに表示されます。列の型を変更するには ヘッダーメニューを使います。テキスト → パスワードへの変換は値をセキュアフレーズで 暗号化し、パスワード → テキストへの変換は確認と PIN/セキュアフレーズを求めたうえで 内容を平文として書き込みます（元に戻せません）。その他の変換では値は保持されます。

ベース（ノートの保存済みクエリ）

ベース（.lnq、ファイル → 新規 → 新しいベース）は、ノートに対する 保存済みクエリです。種類とプロパティで絞り込み、結果を テーブルまたはボードで表示します。ベースはデータを一切保持しません。行は あなたの .md ノートそのものであり、各セルの真実の source は ノートのフロントマターです。.lnq を削除してもノートは失われません。

セルを編集するとノートに書き込まれます。 テーブルでプロパティを変更すると、 ファイルのフロントマターの該当行だけが書き換えられます。ボードでカードを別の列へ ドラッグすると、グループ化プロパティの新しい値が書き込まれます（例: 読書中 から 読了 へ）。

各ノートはフロントマターでプロパティを宣言します（type、 status、author など）。ノートのプロパティサイドパネルを 使うと、生の YAML ではなく型付きフィールド（テキスト、数値、日付、チェックボックス） として編集できます — Markdown ノートを参照してください。

.lnq は NDJSON（1 行 1 レコード）で、Git を前提に設計されて います。2 台のマシンが同じベースを並行して編集しても — 一方が列を追加し、もう一方が フィルターを変更 — マージは両方の変更を競合なく保持します。

宣言したスキーマ（任意）。 LightNote は既定で、ノートが実際に使っている 内容から各型のフィールドを推測します。何も宣言する必要はありません。スキーマを 固定したいときは ツール → ノートの型...（またはノートのプロパティミニバーの 歯車ボタン）を開き、各型のフィールド、そのデータ型（テキスト・数値・日付・ チェックボックス・選択リスト）、既定のテンプレートを宣言します。スキーマが あると、選択リストのフィールドは許可された値のドロップダウンになり、宣言した フィールドはまだどのノートも使っていなくてもベースの列・フィルターの選択肢に現れ、 型のテンプレートを適用ボタンでノートの雛形を挿入できます。スキーマは .lightnote/types.ndjson にあり、マージ可能な NDJSON としてノートと一緒に Git で管理されます。削除してもノートは変わらず、推測に戻るだけです。

フィルターの相対日付。 条件の値には today、yesterday、tomorrow、7 days ago、in 2 weeks のような語が使えます（3 months ago、in 1 week も）。これで 期限 = today や 期限 < today（期限切れ）は明日も同じ意味で働きます——以前はその日の日付を手で書くしかなく、保存したクエリは 24 時間で古くなりました。値はつねに時点で、範囲は演算子との組み合わせから生まれます：更新日 > 7 days ago は「今週さわったもの」です。その項目に読める日付がないノートは、否定を含めどの日付比較にも入りません。手で書いた ISO 形式の日付（2026-09-01）は今までどおりテキストとして扱われます。

インデックスはバックグラウンドで走ります。 ベースとツール → ノートを検索（SQL）は、結果を見せる前にノートを走査します——各ファイルの stat と、前回から変わったノートの読み込みです。これがウィンドウの外で行われるようになりました：ベースはすぐ開き、バーにノートをインデックスしています…と出して、終わったら中身が入ります。その間 再インデックス ボタンは無効です——同じフォルダーをもう一度走査しても得るものがないからです。

ファイル内検索と未対応項目

ファイルと文書を検索する

サイドバーの検索タブでグローバル検索を行うには Ctrl+Shift+F を使います。 ripgrep を利用し、正規表現・大文字小文字の区別・単語単位・一括置換に 対応しています。現在のファイル内では、Ctrl+F で検索、Ctrl+H で置換します。

検索はドキュメントにも届きます。 .md ノートに加えて、 PDF、表計算 (.xlsx/.ods)、Word 文書 (.docx)、LibreOffice のテキスト (.odt)、プレゼンテーション (.pptx)、書籍 (.epub) のテキストを読みます。AI チャット と意味による検索でも同じです。PDF 内の一致をクリックすると、その抜粋がある ページでファイルが開きます。抽出されたテキストはワークスペースの外の キャッシュに置かれ、ファイルが変わると自動で更新され、ファイルがなくなると削除されます。 最初の一回は時間がかかります。PDF が多いワークスペースを開くと数分かかる抽出が始まり、それが終わるまで文書はまだ検索に入っていません。その間、検索タブがそう表示し（文書を準備しています（80 件中 12 件））、もう一度検索できるようになったら知らせます。二回目からは、変わったファイルだけをやり直します。

.rtf、.xps/.oxps、LibreOffice のプレゼンテーション（.odp）、動画字幕（.srt/.vtt）、テキスト形式の表（.csv/.tsv）、保存したページ（.html/.mhtml）、保存したメール（.eml）、Jupyter ノートブック（.ipynb）、書誌（.bib/.ris）、およびプレーンテキスト（.txt）も対象です。 テキストのマークアップ言語には専用の読み取りがあります。reStructuredText（.rst）、AsciiDoc（.adoc）、Org（.org）、Typst（.typ）では、セクションは見出しに、リストと表はこのアプリのものになり、数式は描画され、前文は除外されます。そうしなければ #set page(...) や :stem: latexmath が索引の断片になり、セクション名が本文と一緒に運ばれません。字幕のヒットは、そのされた時刻を開きます。 スキャンした PDF は黙って消えません。ページはあるのに文字がない文書（各ページの写真で、OCR なし）は、そのことを述べる一行とともに索引に入り、検索タブが件数を知らせます。この一文がなければ、本の中にあるはずの語を探して見つからず、検索が壊れていると思ってしまいます。 読めるようにすることもできます。Tesseract を入れておくと（LightNote がワンクリックでの導入を案内します）、PDF の ⋯ メニューにテキストを認識する（OCR）…が現れます。文書ごとに一度だけ走り、数分かかることがあります。終われば、そのテキストは他の PDF と同じように索引に入ります。検索タブの案内は、その状態の最初の文書へ連れて行きます。キャッシュはテキストを平文で保存します。ワークスペースの外、ユーザーフォルダーに置かれます。そこにアクセスできる人は、原本が暗号化ディスクにあっても文書の内容を読めます。.lne ファイル（暗号化されたノート）は決してキャッシュに入りません——ディスク上で読めないことがその存在理由だからです。

LaTeX は専用のリーダーで読み込まれます。.tex ファイルは生のテキストとしては読まれません。プリアンブルは除かれ、\section は見出しになり、\cite は [@key] になり、数式はそのまま通ります — 描画するのは、ノートの数式を描くのと同じエンジンです。検索結果は、その行でファイルを開きます。 ファイルの右クリックメニュー（開いているときはタブのバー）に ノートとして取り込む (.md) があります。ノートは隣に作られ、.tex はそのまま残り、二度取り込んでも上書きされません。 逆方向は、ノートのバーにある LaTeX (.tex) で書き出す... です。

文書のプレビューとソースコード

ドキュメントを開くとテキストのプレビューが表示されます。 .docx、 .odt、.epub、.pptx は読み取り専用で開き、 抽出されたテキストと文書内の画像を表示します — Word のスタイル、画像の配置、 複雑な表、変更履歴はありません。タブはあくまでそのドキュメントです。名前もフォルダーもセッションも、 キャッシュではなくドキュメントを指します。.xlsx の表計算は、はるかに多くを 見せるテーブル表示で開いたままです。

ドキュメントをノートにする。ファイル → 文書をノートとして取り込む...（複数まとめて可）、ツリーのコンテキストメニュー、またはプレビュー自体のノートとして取り込む (.md)ボタンから、.docx、.odt、.epub、.rtf、.pptx、.html、.eml、PDF、LaTeX がファイルの隣の編集できるノートになります。見出し・リスト・リンク・表を含むテキスト、脚注、LaTeX 数式になった Word の数式、そして画像もいっしょに来ます。画像はノートの隣の 添付 フォルダーに保存されます。ドキュメントのタイトル、作成者、日付はプロパティになり、source がどのファイルから来たノートかを示します。元のファイルはそのまま残ります —— 取り込みは変換ではありません ——。もう一度取り込むと、編集した内容を上書きせずに 名前 02.md を作ります。Jupyter ノートブック（ブロックになります）、.csv（表として開きます）、.bib/.ris の文献（引用が直接読みます）、ソースコードには表示されません。構造は文書のスタイルから取り出されます。Word の見出しはスタイル名が翻訳されていても認識され、文字スタイルから太字・斜体・コードが、引用とコードの段落からこちらのブロックが作られ、自動目次はノートが最新に保つ [TOC] になります。.rtf からはリスト・表・リンクが、HTML（Word や Google ドキュメントが保存したものを含む）と EPUB からは見出し・入れ子のリスト・表が入ります。

このフォルダーが他のエディターの書き方をどれだけ使っているかを見る。 ツール → フォルダーの互換性を確認... を選ぶと、LightNote は開いているフォルダーのノートを読み、見つかったものを三つのグループに分けます。描画するもの（ウィキリンク、トランスクルージョン、コールアウト、タグ、ハイライト、数式、脚注、タスク、ブロック識別子）、ファイルには残るが描画されないもの（プラグインのクエリ dataview、tasks、query、.canvas のキャンバス、.base のベース、ブロックのトランスクルージョン）、そして変換できるもの（こちらの書き方に）です。変換するかどうかはあなたが決めることで、保存の副作用では決してありません。構文にチェックを入れ、左右に並んだプレビューを見て確定します。変更される各ファイルは書き込み前にファイルの履歴へ記録され、未保存の変更があるまま開かれているものは対象外です。変換は今のところ二つで、どちらも Obsidian 側で失われるものはありません（あちらは両方の書き方を読めます）。このフォルダーを指す obsidian:// リンクは [[ノート]] になり（別の保管庫を指すものはリンク先が変わるため変換しません）、行内の脚注 ^[テキスト] は [^n] になって定義が末尾に置かれます。

Notion の蓄積をまとめて取り込む。 Notion で Export → HTML（または Markdown & CSV）を Include subpages 付きで実行し、ダウンロードした .zip（またはフォルダー）をワークスペースの中に置き、取り込み先のフォルダーを作ってから lnote vault-import --path <書き出し> --out <取り込み先> を実行します（AI アシスタントからは vault_import ツールでも実行できます）。展開する必要はありません。中にもう一つ .zip が入っているワークスペース全体の書き出しでも同じです。各ページはノートになります。ページのプロパティはノートのプロパティになり、Notion の色つきコールアウトはこちらのボックスになり（HTML では色が種類を決めます。Markdown は色を保存しないので、ボックスはノートとして届きます）、タスクはチェックの有無を保ったまま届き、数式は LaTeX の数式になり、折りたたみブロックは <details> のボックスに（折りたたみ見出しは見出しに）なり、ページの目次は [TOC] になり、ページ同士のリンクは新しいノートへ書き換えられます。同じ題名のページが二つあっても共存します。二つ目が 名前 02.md になり、リンクは正しい方を指したままだからです。データベースは .csv として Anexos にコピーされます。Notion で書いた #話題 は文字のままです。あちらでタグでなかったものは、ここでもタグになりません。何も上書きされず、隣にレポートのノートが書かれ、入ったノートと添付の数、そして行き先が見つからなかったリンクを一覧にします。そのリンクは書かれたままの姿で残ります。

操作はメニューにあります。ファイル → 他のアプリからインポート... でアシスタントが開きます。書き出したフォルダーまたは.zip（Evernote の .enex でも構いません）を選ぶと、元のアプリはファイル名の形から判別されます。判別できない場合は隣の一覧から選んでください。フォルダーはサブページも含めて丸ごと読まれます。保存先にはワークスペース内の新しいフォルダー（アプリ名）があらかじめ入っているので、取り込んだ資料が自分のノートと混ざりません。読み書きはウィンドウの外で走り、最後にノートと添付が何件入り、リンクを何件書き換えたかが画面に出ます。

対応するのは 5 つのアプリです。Notion は HTML か Markdown で書き出したフォルダーか .zip、Evernote は .enex、Joplin は .jex（または MD + Front Matter のフォルダー）、Logseq はグラフのフォルダー（logseq/config.edn が入っているもの）、Roam Research は書き出した .json です。どれでも、ノートブックと名前空間はフォルダーになり、日誌は yyyy-MM-dd という名前でデイリーノートのフォルダーに入り、タスクは - [ ]、ハイライトは ==このように==、ブロック参照はそのブロックの文と、それが置かれているページへのリンクになります。他のアプリの記法はワークスペースに入りません。ここに相当するものがない Logseq のクエリや Roam の表などは行内コードとして残り、レポートが件数を伝えます。

ソースコードも意味による検索に入れられます。ワークスペース → このフォルダーの設定にソースコードを意味による検索に含めるがあります。コードのファイルがノートと一緒に索引され、関数やクラスごとに 1 つの断片になります——「タイムアウトはどこで処理している？」のような問いが、if の途中で切られた断片ではなく関数まるごとに当たるのはこのためです。.gitignore は尊重されます。既定はオフで、フォルダーごとです。ノートはゆっくり変わりますが、コードは一日中変わり、作業中のリポジトリは数万の断片を生みます——その一つ一つが、エンベディングの提供元に課金される呼び出しです。

ハイライト・マーク・未対応項目

強調表示とマークは別のものです。 クイック検索（Ctrl+F）は該当箇所を アンバー色で強調表示するだけです。これは一時的なもので、バーを閉じるか入力欄を 空にすると消えます。一方、編集 → 詳細検索… のすべてマークはあなたの意思に よる操作です。該当箇所を赤く塗り、その行にブックマーク（余白の青い丸印）を追加します。 これはマークをクリアを使うまで残ります。両者は独立しています。クイック検索を閉じても マークしたものは消えず、マークをクリアしても検索の強調表示は消えません。どちらもミニマップの マーク帯に、それぞれの色で表示されます。 マークをクリアはすべてマークが付けた印だけを消します。検索に一致する行に自分で（Ctrl+F2）付けたブックマークはそのまま残ります。

サイドバーの未対応項目セクションは、コードの TODO/FIXME マーカーと、ワークスペースの Markdown ノートのタスク （- [ ]）を 1 か所に集めます。クリックすると該当行に直接移動します。

バージョン管理（やさしい Git）

リポジトリをクローンする

すでにあるリポジトリで作業するには ファイル → Git リポジトリをクローン... を使います。この項目はスタート画面にも、まだリポジトリでないフォルダーのバージョン管理パネルにもあります。リポジトリのページに表示される HTTPS または SSH のアドレスを貼り付けてください。ページ自体の URL でもよく、git clone ... をそのままコピーしたものでも構いません。保存先の親フォルダーとフォルダー名を選ぶと、どこに作られるかが表示され、そこに既に何かある場合は知らせます。詳細オプションにはブランチ、シャロークローン（最後のコミットだけ）、サブモジュールがあります。

サーバーがログインを求めると、LightNote はウィンドウで尋ねます。ユーザー名とトークン、SSH 鍵のパスフレーズ、あるいはこのコンピューターが一度も見たことのないサーバーの鍵の確認です。最後の場合はフィンガープリントと、サービスが公開している一覧へのリンクが表示され、既定は信頼しないです。回答は Git に直接渡され、LightNote は保存しません。保存するのは Git の資格情報マネージャーで、インストールされている場合に限ります（Git for Windows には Git Credential Manager が含まれます）。鍵を信頼すると、ssh 自身と同じように ~/.ssh/known_hosts に書き込まれます。

クローンに失敗した場合、画面は何が起きたかを伝え、出口を示します。SSH 鍵が拒否されたときは HTTPS で試す、会社のプロキシが HTTPS を検査しているときは Windows の証明書を使う、途中で接続が切れるときは最後のコミットだけ取得する、Windows がファイルを作れないときは長いパスを使う、といった具合です。技術的な詳細には Git のメッセージが入り、認識できないものは AI に渡せます。終わると、クローンしたフォルダーをこのウィンドウか新しいウィンドウで開きます。

開いているフォルダーをバージョン管理する

バージョン管理はワークスペースごとのオプトインです。ツール → ワークスペースの設定で 有効にすると、LightNote は Git リポジトリを作成し（まだない場合）、バージョン管理の サイドバー（Ctrl+Shift+G）を表示します。

自動モードでは、LightNote が全般設定で選んだタイミング（保存時・タブを閉じたとき・ ウィンドウを閉じたとき）で自動的にバージョン（コミット）を保存します。手動モードでは、 メッセージを書いてパネルでバージョンを保存します。ステータスバーのインジケーターは状態 （変更なし、X 件の変更…）を示し、クリックするとワークスペースの設定が開きます。 各ファイルの差分を表示し、未保存の変更を復元（破棄）できます。

自動化にはフォルダーごとに 3 段階があります（ワークスペースの設定）: 手動（自動処理なし）、自動コミット（自動でバージョンを保存するが同期はしない）、 すべて自動（コミットして同期する — コミット後にプッシュ＋定期的にプル。 プロンプトなしの Git 認証情報が必要）。パネルにはリモートに対する↑ 送信予定 / ↓ 受信予定 のステータス行が表示され、送信するバージョンがあるときは主ボタンがコミットから 同期に変わります。これにより、保存後にまだ同期が必要なことが分かります。

Git パネルとツリーの Git メニューには、ファイルごとの 追加 (git add) と 復元 (git restore)、そして比較画面を開く 変更を見る の 1 つがあります。

比較画面は 2 つのバージョンを左右に並べ、行をそろえて表示します。同じ部分はつねに向かい合い、それぞれの側にはそのファイルの行番号が出ます。書き換えられた行は琥珀色になり、変わった部分が行の中で強調されます。統合表示ボタンでパッチ形式に切り替わり、左右を入れ替えで比較の基準が入れ替わり、F8 / Shift+F8 で変更を次々にたどれます。

履歴と変更の帯

コードエディターとノートのバーにある 履歴 ボタンは、開いているファイルのバージョン一覧を開きます（サイドバーの同じセクションです）。ここには コミット と、LightNote が Ctrl+S のたびに記録する ローカル保存 がまとまるので、リポジトリではないフォルダーでも使えます。各行には件名、作成者、日時、増減した行数が並び、丸印で自分のコミット・LightNote 自身の保存・AI セッション由来のコミットを見分けられます。コミットしていない変更があるときは、それが先頭行になります。バージョンをクリックすると、そのバージョンでの変更が表示されます。バージョン全体を開く、現在のものと比較する、選択した 2 つを比較する、は右クリックにあります。

バージョン管理が有効なとき、余白の色付きの帯が最後のコミットからの変更行を示します — コードエディターだけでなくノートでもです。帯は入力に追従し、元に戻すと保存を待たずに消えます。切るには表示 → 変更の帯。切ると隠れるだけでなく、計算そのものが行われません。帯をクリックすると以前の内容が表示され、この部分を元に戻す（Ctrl+Z で取り消せます）、元の内容をコピー、そして完全な比較をその行に合わせて開く 差分で見る が使えます。ローカル履歴について 1 点だけ: パスごとに保存されるため、ファイル名を変更するとそのローカル保存は失われます。Git のコミットは失われません。

スナップショットとバックアップ

バージョン管理パネルの ⋯ メニュー（またはツール）から:

  • スナップショットを作成: 現在の状態に日時のラベルを付けて、後で戻れるように します。
  • スナップショットを復元: スナップショットと操作を選びます — 履歴を保ったまま ファイルを戻す（推奨）、履歴をその時点まで巻き戻す、または別のコピーとして開く。
  • コピーをエクスポート（.zip）: ワークスペース全体を自己完結型のファイルに 圧縮し（プロジェクトマーカーを埋め込み）、送付や別の場所への保管に使います。
  • ワークスペースのフォルダーを移動…: ディスク上でルートを移動し、セッションと レジストリのパスを調整します。

変更のレビュー（チェックポイント）

ツール → 変更をレビュー…は、基準以降にワークスペースで変更されたすべての 集約差分を 1 つのタブに表示します。左に追加/変更/削除されたファイルの一覧、右に選択した ファイルの差分。作業を受け入れる前に AI CLI セッションが何を変更したかをレビューする ために設計されています。

基準は最後のバージョン（HEAD）またはチェックポイントにできます。タスクを始める前に チェックポイントを作成し（タブ上のボタン）、後で比較します。チェックポイントはコミットを 作成せず、履歴に一切触れません。フォルダーでバージョン管理を有効にしている 必要があります。

コメントのまとめ送信。AIセッションのレビューでは、コメントボタン（ファイル一覧のコンテキストメニューにも）で選択したファイルについてコメントを書き留めます（選んだ抜粋に紐づけられます）。コメントはリストにたまり、セッションに送信を押したときに初めて、1 通にまとめて CLI のターミナルへ渡されます。これは意図的です。1 件ずつ送ると、各ラウンドが他の指摘を見ていないため、エージェントが一方を直して他方を壊してしまいます。修正後もコメントはリストに残り、対応されたか確認できます。解決済みにチェックを付けると次回の送信から外れます。コメントした範囲をエージェントが書き換えた場合、コメントは消えずに薄く表示されます。 送信はステータスバーで確認でき、休止中のセッションはまとめを受け取るために自動的に再開されます。

ファイルの比較（差分）

ツール → 2 つのファイルを比較…は、両方を並べて（2 つのエディター）開き、 行ごとに差分をマークします。比較は読み取り専用です。

◀ / ▶ ボタン（または F8 / Shift+F8）で前後の変更へ移動します。Git パネルからは、ファイルを保存済みバージョンと横並びで比較することもできます（HEAD 対 ディスク）。

コードの実行（F5）

ツール → ファイルを実行（F5）は、現在のファイルを保存し、拡張子に登録された インタープリターに従ってターミナルで実行します。既定では .py、.sh、 .bat、.cmd、.sql をカバーします。インタープリターは 設定 → 実行で編集/追加できます。

コマンドは {file}（ファイル）、{folder}（フォルダー）、 {name}（名前）を含むテンプレートです。例えば Python なら python {file} です。Ctrl+Shift+Enter で選択範囲/現在の行だけを ターミナルに送ることもできます。ブロックでは、各セルが同じ仕組みで 実行されます。

実行ボタンには、複数のターミナルが開いているときに対象のターミナルを選んで記憶するためのドロップダウンがあります。

クリックできるエラー。 出力パネル（F6）では ファイル:行 の参照がリンクになります。Ctrl+クリックまたはダブルクリックで、その位置にファイルを開きます。Python のトレースバック、Node のスタック、コンパイラ（gcc/clang/MSVC）のエラー、リンターの出力に対応します。実際にディスク上に存在するものだけがリンクになり、それ以外は通常のテキストのままです。

エラーを順に見る。 出力パネルでは F8 で次のエラー、Shift+F8 で前のエラーへ移動します（パネルのバーにボタンもあります）。移動は循環し、出力を該当箇所までスクロールして強調表示し、ファイルをその位置で開きます。

ターミナルと AI CLI

コマンドごとのステータス点。 実行した各コマンドの横に点が表示されます。成功なら青、失敗なら赤（ツールチップに時刻・所要時間・終了コードが出ます）。LightNote は PowerShell と Git Bash で設定を変更せずに自動で有効にします。設定 → ターミナル → シェル統合でオン／オフできます。その他のシェル（cmd、WSL）やカスタムコマンドでは点は表示されません。

Ctrl+'（US キーボードレイアウトでは Ctrl+` も）で統合ターミナル（ConPTY 経由の完全な VT エミュレーター）を開きます。 これはタブになり、ウィンドウの各エリア間で移動できます。利用できるシェルと、PATH で検出された AI CLI（例: claude）は、設定 → ターミナルと 設定 → AI アシスタントで構成できます。新しいターミナルメニューで AI CLI を選ぶと、 その CLI がターミナルとして開きます — TUI/色は通常どおり表示され、終了するとタブが 閉じます。

送信を予約。 ターミナルのコンテキストメニュー（右クリック）の 送信を予約… から、あとで Enter（またはテキスト）を送れます。 利用制限がリセットされたときに AI CLI を再開するのに便利で、張り付いて待つ必要が ありません。トリガーを選びます: 指定時刻に、数分後、一定間隔ごと （繰り返し）、またはターミナルがアイドルになったとき。実行までコンピューターは スリープしません。予約はターミナルのタブが開いている間だけ有効です。

複数の予約を同時に持てます。予約があると、メニュー項目は 予約済みの送信 (N)… に変わり、マネージャーを開きます: ターミナル、 送信内容、時刻、次回発火までのライブカウントダウンを並べた表で、新規・ 編集・削除ボタンがあります。予約がある間は、ステータスバーに 件数付きの時計インジケーターが表示され（クリックでマネージャーを開く）、 小さな時計が予約済みのターミナルタブに付きます。

AI のターン終了通知。 AI の CLI ターミナルが静かになると（エージェントがターンを終えた合図です）、LightNote が知らせます。トーストが表示され（クリックするとそのターミナルにフォーカスします）、タブが数回点滅したあと、開くまで強調表示が残ります。ウィンドウが背面にあるときは、タスクバーのボタンも点滅します。通知は AI の CLI ターミナルに限られ、そのタブにフォーカスがないときだけ働きます。オン/オフと無音とみなす時間は 設定 → ターミナル → AIのターン終了通知 で調整できます。

ターミナルはウィンドウと一緒に戻ります。ワークスペースを閉じて開き直すと、通常のシェルのターミナル（コマンドプロンプト、PowerShell、Bash）が再び開きます。しかも作業していたフォルダーで開きます（ターミナルを開いた時のフォルダーではありません）。画面の内容は戻りませんが、コマンドの履歴はシェル自身のものなのでそのまま残り、↑ キーは通常どおり使えます。AI アシスタントのセッションは対象外で、これまでどおり別途たずねられます。新しいターミナルは同じ会話ではないからです。環境変数や、そのセッションで手作業で有効にした環境（venv など）も戻りません。ターミナルは正しいフォルダーで開きますが、中身は新しいシェルです。

選択範囲への AI アシスタント（Ctrl+K / Ctrl+I）

AI に聞く・AI で編集する

デフォルトの AI。 設定 → AI アシスタント の上部にある デフォルトの AI は、Ctrl+K/Ctrl+I、AI チャット チャット（セッションごとに変更可）、および自動処理（質問の書き換え、要約、音声の要約、コンテキスト生成）で使うアシスタントを選びます。CLI と API プロバイダーの両方を一覧します。音声の文字起こし と embeddings には専用のプロバイダーがあり、LightNote は選んだプロバイダーに応じて モデルを提案 します。

エディターで Ctrl+K（AI に質問）または Ctrl+I（AI で編集）を、選択あり/なしで 押すと、浮動のインラインチャット風ポップアップが開きます。プロンプト欄は空行の下に選択範囲が あらかじめ入っています。その上に指示を入力し、Ctrl+Enter で送信します。ポップアップでは AI（既定の AI が事前選択）と結果モードを選びます: 差分で選択範囲を置き換える （元 × 提案、適用 / コピー / 破棄付き）か、回答をテキストで表示するだけ にします。

LightNote は AI CLI を「ワンショット」モードで実行します（ターミナルを開きません）。 CLI と既定の AI は 設定 → AI アシスタントにあります。

モデルをつなぐ

API のモデル。ローカル CLI に加えて、設定 → AI アシスタントで OpenAI 互換 API（OpenAI、Groq、DeepSeek、OpenRouter、Gemini、Anthropic、Ollama／LM Studio などのローカルインスタンス…）の LLM モデルを登録できます。カタログからプロバイダーを選び（ベース URL は設定済み）、キーを貼り付け（このコンピューターにのみエンコードして保存）、モデルを取得…とテストを使います。登録したモデルは Ctrl+K の同じ選択肢に CLI と並んで表示されます。

ワンステップで接続。通常の手順は表に入力することではありません。設定 → AI アシスタントでAI を接続…をクリックし、プロバイダーを選び（一覧には無料プランありのものと、お使いのコンピューター上、キー不要で動くものが示されます）、3 つの手順に従い、ボタンでキーのページを開いてキーを貼り付けます。アドレスとモデルは LightNote が自動で入力し、保存する前に接続をテストします。キーの誤りは会話の途中ではなくその場でわかります。上の一覧には接続済みのものと、不足があるものについて何が足りないか（「キーが未入力です」「モデルが未選択です」）が表示され、ダブルクリックするとそのプロバイダーで再び接続画面が開きます。

細かい調整。アドレス、モデル、MCP の許可、CLI のコマンド、音声の文字起こし、埋め込みは、いずれもページ下部の詳細設定にそのままあります。接続画面の詳細オプションでも、接続前にベース URL とモデルを変更できます。何も削除していません。始めたばかりの人の前から動かしただけです。 エンベディングには任意の次元数という項目もあります。モデルによってはより小さいベクトル（1536 ではなく 512）を返せて、ほとんど品質を落とさずにキャッシュが半分になります。わからなければ（モデルの既定）のままにしてください——すべての提供元がこのパラメーターを受け付けるわけではありません。値を変えるとキャッシュは無効になります：次元の違うベクトルは比較できないので、破棄され、次の検索で作り直されます。その分の呼び出しは新たに課金されます。

失敗にも種類があります。 求められる対処が正反対なので、LightNote は種類を分けて扱います。プロバイダーの混雑と呼び出し頻度の制限は時間が解決します。アプリが自分で呼び出しをやり直し、プロバイダーが求めた待ち時間も守るので、それでもだめだったときだけエラーが出ます。残高や利用上限は何度繰り返しても解決しません。無駄に試さずに済むよう、メッセージがそう伝えます。会話が長くなりすぎたときに必要なのは新しいセッションで、別のモデルではありません。そしてモデルの問題——提供終了、アカウント外、プランの対象外、あるいは呼び出しを受けたまま応答しない——だけが、モデルを替えれば解決するものです。 求められた待ち時間が長すぎるときは、窓を止めたままにせず、何秒を求められたのかをメッセージが伝えます。

モデルを自動で切り替える。 現在のモデルが失敗したら自動で切り替えるにチェックを入れると、LightNote はその場に表示された順に、そのプロバイダーの推奨モデルを試します。既定でオフなのは意図的です。試行の一つ一つがあなたのアカウントに課金される呼び出しだからです。代わりのモデルが、あなたが選んだモデルより高くつくことはありません——一覧は高い順に公開され、アプリはそれを下る一方だからです。一覧にない独自のモデルは、いちばん安いものに直接落ちます。プロバイダーに保存されるのは決定的な失敗のときだけです。ネットワークの問題だった場合、切り替えはその呼び出しかぎりで、あなたの選択はそのまま残ります。切り替えは決して黙って行われません。どのモデルが応答したか、変更が保存されたかを通知が伝えます。

そして、失敗より先に届く知らせ。 自動の切り替えは呼び出しが失敗したあとにしか働きませんが、LightNote が自分で参照しているモデルのカタログは、たいていそれより先に提供終了を知っています。LightNote 自身が登録したモデルがカタログから外れると、その旨が知らされ、設定 → AI アシスタント に後継へ移るボタンが現れます。後継は、同じ規則により、けっして高くなりません。この知らせは、アプリが選びあなたが一度も触っていないモデルにだけ働きます。あなたが入力したモデルはあなたの選択であり、LightNote は口を出しません。

どれも応答しないとき。 LightNote は何が起きたかを伝え、モデルを替える、別のアシスタントを使う、解決するまでそのプロバイダーを無効にするのいずれかを提案します。無効にしたプロバイダー（詳細の表の有効列）は、キーもそのほかの設定も失わずに一覧から消えるだけです。アシスタントの一覧では、それぞれがローカルかクラウドかを示します。クラウドのものを選ぶと、送信したテキストはあなたのマシンの外に出ます。

キー不要：ローカル LLM

まだ AI がない場合。 アシスタントを接続していない状態で Ctrl+K を押すと、LightNote がそのことを説明し、その場で接続することを提案します。接続するとすぐに、指示した操作がそのまま続きます—ショートカットを押し直す必要はありません。

ローカル LLM（キー不要）。ローカルプロバイダー（Ollama、LM Studio、llama.cpp）に API キーは不要です。追加から選び（サーバーが起動しているかどうかが一覧に表示されます）、モデルを取得…で取得済みのモデルから選択します。Ollama が未インストールの場合は、LightNote がインストールを案内します。初回起動時に登録済みなので、モデルを選ぶだけです。ローカルモデルは応答に時間がかかることがあるため（特にモデルを読み込む初回の生成時）、LightNote はクラウドサービスよりもはるかに長く待ちます。あなたのテキストがターミナルの外に出ることはありません。

反映・プロンプト・操作のありか

ブロック単位で受け入れ。 結果が 差分 で表示されるとき、すべてを受け入れる必要はありません。変更された各ブロックには含めるかどうかのチェックボックスがあり、最終的なテキストは残したブロックだけで再構成されます。プロンプトにはファイルの自動コンテキスト（パス、言語、選択範囲の前後の行）も含まれるため、何も貼り付けなくても AI がより正確に答えます。

プロンプトライブラリ。 AI → プロンプトライブラリ… は、再利用できるプロンプトをワークスペースの Prompts/ フォルダー内の .md ファイルとして保管します。オープンな形式で、Git で版管理でき、あなたのセカンドブレインの一部になります。選択画面には検索・プレビュー・新しいプロンプトを作るボタンがあります。ひとつ選ぶと {selection}、{file}、{folder}、{name}、{language} の各項目が現在のエディターの文脈で埋められ（独自の変数はそのまま残ります）、本文が Ctrl+K の入力欄に挿入されるか、アクティブな AI ターミナルへ送られます（送信はしません）。

コードエディターだけではありません。 AI 操作（Ctrl+K / Ctrl+I とコンテキストメニュー）は、Markdown エディター、タスクの埋め込みノート、データベースの SQL クエリエディター でも使えます。いずれもカーソル上にポップアップが開き、その場に結果を適用します。

AI の操作はすべて AI メニューにまとまっています（☰ ボタンと、アクティビティバーの杖ボタン）: AI に質問（Ctrl+K）、AI で編集（Ctrl+I）、AI セッション、AI チャット、プロンプトライブラリ、プロジェクトのコンテキストファイルを生成、このフォルダーで AI を有効化、AI アシスタントの設定。

入力中はウィンドウが閉じません。エディターをクリックしても閉じないので、コードを読み返したり別の箇所を選択したりしても、すでに入力した指示は失われません。閉じるのは Esc、ウィンドウの ✕、そして結果の操作（適用／破棄）です。タブを切り替えると、書きかけの内容を保ったままいったん引っ込みます。同じファイルに戻って Ctrl+K を押せば、指示は途中からそのまま現れます。

AI セッション

セッションと隔離コピー

AI → AI セッション… は、どの LightNote ウィンドウで開いた AI CLI ターミナルもセッションごとのカードで表示するコックピットを開きます。色付きの状態インジケーター、CLI 名、ウィンドウ、そして注意が必要なもの（予約送信、隔離コピー）のバッジが並びます。ダブルクリックでターミナルをフォーカスし、カードの ⋯ メニュー（または右クリック）からそのセッションの変更をレビューしたり（セッション開始時に作成されたチェックポイントを基準にレビュー画面を開きます — 変更をレビューを参照）、送信を予約したりできます。複数の「バイブコーディング」セッションを、ウィンドウ間で迷わずに同時に見張るための方法です。

Git リポジトリ内で AI CLI をターミナルとして開くと、LightNote は自動的にチェックポイント（ラベル「セッション …」）を保存するので、そのセッションが変更した内容を後から正確に確認して元に戻せます。この機能は 設定 → 一般 → 機能 でオフにできます。

隔離コピー（worktree）: Git のフォルダーでは、LightNote は AI アシスタントをフォルダーの隔離コピー（専用のブランチ）で実行でき、手で編集しているファイルには触れません。初回は確認し、その後は自動です（ワークスペース設定 → 連携でフォルダーごとにオン/オフ）。隔離コピーバッジがそのセッションを示し（ブランチとパスはツールチップにあります）、マージ…の項目（変更を自分のフォルダーに取り込む。保留中の変更があれば先に確認します）と破棄…（コピーとブランチを捨てる）でサイクルを締めくくります。

アイドル・コンテキスト・休止

アイドル状態の通知。AIのCLIがアイドル状態になると（完了した、または入力待ち）、LightNoteが通知を表示します。クリックするとそのセッションの変更のレビューが開きます。作業を始めてその場を離れられます。設定 → ターミナルでオフにできます。

プロジェクトのコンテキストファイル。コンテキストファイル（CLAUDE.md または AGENTS.md）のないフォルダーでAIのCLIを開くと、LightNoteが生成を提案します。ツール → プロジェクトのコンテキストファイルを生成…からいつでも作成できます。良いコンテキストファイルはプロジェクトの構造や規約を説明し、毎回説明し直さなくてもAIのミスを減らします。AIプロバイダーが設定されていればそれが内容を生成し、なければ記入用のひな型が得られます。

アイドルなセッションの休止。止まっている AI CLI もメモリ（会話とモデルのクライアント）を抱えたままです。設定 → ターミナルで無音の時間を指定すると、LightNote はプロセスを終了し、そのタブに戻ったときに自動で再開します。ターミナルの履歴は画面に残ります。既定では有効（30 分）です。停止中の Claude Code セッション 3 つで 1 GB を超えることが測定で分かっています。独立したコピーで動作し、フォルダーの会話を再開できる CLI（現在は Claude Code と Antigravity）のセッションにのみ適用されます。そうでないと他のセッションの会話を持ち出してしまうからです。 送信予約のあるセッションは休止しません。また、戻るのは会話であり、ツールの画面ではありません。入力しただけで送信していないテキストは失われます。

アクティビティと意味による検索

アクティビティタブ。表は今動いているものを示し、アクティビティタブは履歴を保ちます。エージェントがターンを終えたとき、独立したコピーで開始したとき、休止したときが、日時と直近の応答の抜粋とともに残ります。未読は太字で表示され、件数は通知領域のメニューにも出ます。通知は一瞬で消えるため、席を外していた人でも見逃しに気づけます。タブを開くとすべて既読になり、ダブルクリックでそのセッションに戻れます。 セッションの終了も記録されます（CLI が自分で終了した場合も含みます）。離席中に落ちたセッションが、跡形もなく消えるのではなく履歴に残ります。イベントのセッションがすでに開いていない場合、ダブルクリックは何もしないのではなく、その旨を伝えます。

意味で検索する。検索が文字どおりの一致を見つけられなかったとき、結果の横に意味で検索が現れます。語をつき合わせる代わりに、同じことについて書かれたノートを探します。書いた言葉は思い出せないけれど、考えは覚えている、というときに役立ちます。ほかのボタンの隣にある ~ で直接切り替えることもできます。このモードでは、正規表現・単語単位・大文字小文字・ファイル絞り込み・置換が消えます。どれも類似検索には当てはまらないからです。この機能には 設定 → 一般 → 機能 の意味による補強（埋め込み）が必要で、無効なときはボタンがその画面へ案内します。フォルダーごとに初回だけ、索引化する断片の数を示して確認を求めます。この索引化はプロバイダーの課金対象ですが一度きりで、以後は検索ごとに問い合わせ分だけかかります。

AI チャット

仕組み

AI → AI チャット… は、自分のノートを文脈として回答するチャットを開きます。すべてをクラウドに送る代わりに、LightNote はボールト内の最も関連する抜粋をローカルで取得し（ripgrep を使用、埋め込みも外部サービスも不要）、その抜粋で質問を組み立てて、登録済みの API の AI プロバイダーに送ります。回答には出典ノートがクリックできる引用として付き、クリックするとノートが開きます。「第二の脳と対話し」、すでに書き留めたことを再発見するのに最適です。会話履歴はメモリ上だけに残り、保存されません。この機能は 設定 → 一般 → 機能 でオフにできます。

ウィンドウの構成。 選択項目は上部の 1 本のバーにまとまっています。AI、ノートのフォルダー、そしてテキストエディターが有効なときはコンテキスト。右側には 2 つの許可（ツール と 変更を許可）と、新しい会話を始める + ボタンがあります。最初の質問の前には、何について答えるのかを画面が示し、このフォルダーを要約 などの 1 クリックのショートカットを提示します。質問欄では Enter で送信、Shift+Enter で改行です。応答中は送信ボタンが 停止 に変わります。

ツールと許可

AI にツールを使わせる。 変更を許可 のチェックで動作が変わります。キーワード検索で取れた抜粋だけで答えるのではなく、モデルが自分で調べて（ファイルを読む、ノートを検索する、タスクを一覧する）から答えるようになります。オンにすると、LightNote は選んだモデルがツールを呼べるかをその場で確認します。多くのプロバイダーはリクエストを受け付けながらツールを無視するため、この確認がないと、調べたように見える作り話が返ってきます。判定はプロバイダーとモデルの組み合わせごとに 7 日間記憶されます。API のプロバイダーが必要です（ローカル CLI はツールを受け取れません）。回答の最後に実際に使ったものの一覧が出るので、鵜呑みにせず判断できます。 判定が否定的だった場合（そのときプロバイダーが単に落ちていただけかもしれません）、メッセージの横に 再確認 ボタンが現れ、保存された結果を無視してテストをやり直します。

AI に変更させる。 2 つめのチェック 変更を許可 は別段階で、オフから始まります。これを入れると、AI はノートやタスクの作成、プロパティの変更、今日のノートへの記録もできますが、あなたの承認なしには何も起きません。変更は会話の中に平易な言葉で表示され（「タスク パンを買う を作成」）、許可 と 拒否 が並びます。拒否しても会話は終わりません。モデルに伝わり、説明したり別の方法を提案したりして続きます。読むだけなら確認は不要で、変更のときだけ尋ねます。任意のファイルの上書きとネットワーク接続は意図的に対象外です。AI が読むだけである限り、外部から同期されたノートに紛れ込んだ悪意ある文章がディスク上の変更に化けることはありません。 変更が今日のノートへの追記の場合、その要求にはどのフォルダーに書き込まれるかも表示されます。書き込み先のファイルが AI の要求に含まれない唯一の操作だからです。

何について答えるか

ノートか、開いているファイルか。 ウィンドウ上部の コンテキスト: で、会話の対象を選びます。Vault のノート（既定。下記参照）か、現在のエディタ です。後者は vault ではなく エディタで開いているファイルについて答え、選択範囲とその周辺（または ファイル全体 のチェックでファイル全体）を使います。こうして同じチャットで、ノートについても、編集中のコードについても、複数ターンで会話できます。現在のエディタ はテキストエディタがアクティブなときだけ表示されます。さらにクイックアシスタント（Ctrl+K）では、結果に チャットで続ける → ボタンがあり、このウィンドウを 現在のエディタ の状態で開き直し、そのときの質問と回答を引き継ぎます。やり直さずに深掘りできます。

どのノート？ このウィンドウは1つだけで、一度に1つのフォルダーについて回答します。上部バーの AI 選択の隣にある ノート: のコンボが、その対象を表示・選択します。チャットを開いたウィンドウのフォルダーが最初から選ばれ、現在開いているフォルダー、続いて最近のフォルダーが並びます。フォルダーを選択… でそれ以外も指定できます。切り替えは以降の質問に適用され、別のプロジェクトで作業しながら、あるプロジェクトのノートについて AI チャットすることもできます。手動で選んだフォルダーは、再び変更するまで有効です（ウィンドウを開き直しても対象は戻りません）。 質問の処理中は（確認待ちで止まっている間も含めて）、AI・コンテキスト・フォルダーの各セレクターがロックされます。返ってくる答えは、質問した時点のモデルとフォルダーのものだからです。

質問のしかた。 検索は話題で行われ、指示では行われません。LightNote は質問から語句を取り出し、それを含むノートを探します。「Postgres について何をメモした？」のようにノートに出てくるテーマを挙げてください。「要約して」のような漠然とした依頼には検索できる内容語がないため、何も取得されず、回答があなたのノートを使っていないとチャットが知らせます。読み込むのは .md/.markdown のノートだけで、それが1つもないフォルダーではチャットがその旨を伝え、AI 呼び出しを消費しません。

より良い検索・要約・書き換え。 検索は BM25 ランキングのローカル索引を使い、アクセントを無視し（「configuração」で「configuracao」が見つかる）、単語の区切りに空白のない言語（日本語・中国語・韓国語）でも機能します。索引を構築している間は ripgrep が補助します。このフォルダーを要約 ボタン、そしてエクスプローラーのフォルダーの右クリックメニューにある AI で要約… は、ノートをまとめて読み、ひとつの文書を返します。また 設定 → 一般 → 機能 の AI が質問を書き換える を使うと、検索前に質問をキーワードへ拡張します（質問ごとに API 呼び出しを1回消費）。

キーと会話

鍵を1つ貼るだけ。 初回起動時、LightNote は OpenAI・Google Gemini・Anthropic (Claude) を 設定 → AI アシスタント にあらかじめ登録済みです。使うプロバイダーに API キーを貼り付けるだけで済みます。どのプロバイダーにも鍵がない場合は、ウィンドウに 今すぐ設定 ボタンが表示され、その画面を直接開きます。

会話は保存されます。 上部の時計ボタンで、そのフォルダーの以前の会話の一覧を開きます。クリックするとその会話に戻ります。新しい会話は現在の会話を削除せずに保管し、一覧で右クリックすると（確認の上）完全に削除できます。会話はフォルダーごとに保存されるため、ノートのフォルダーを変えると一覧も変わります。

回答をどう使うか

回答をどう使うか。 各回答の下にコピー（書式を保ったまま Markdown のテキストをクリップボードへ）とノートに取り込む（引用されたノートへのリンクとともに今日のノートへ）があります。会話の操作メニューには会話をコピー、会話をノートとして保存…（参照したフォルダーに .md を作成）、最後の回答をやり直す、最後の質問を編集があります。

ファイルを添付する。 検索が目的のものを見つけられないときは、+ ボタンでファイルを添付します。添付したものは検索の順位争いとは無関係に、常に質問に含まれます。ノート、コード、テキスト、PDF に対応しています（PDF はテキストを抽出）。バイナリはその場で拒否され、コンテキストのノイズになりません。添付はピル形式で表示され（クリックで解除）、新しい会話を始めると消えます。対応している提供元では、回答もモデルが書くにつれて少しずつ表示されます。

アシスタントの記憶。上部の ☰ ボタンの会話の操作メニューにあるアシスタントの記憶…で、選択中のフォルダーのルートにある 記憶.md ノートが開きます（初回は作成されます）。その中身は、そのフォルダーについてのすべての質問に、見つかった抜粋よりも先に入ります。あなたの好み、すでに下した決定、見送ったものとその理由などです。ふつうの .md なので、いつでも編集でき、Git で管理でき、削除すれば記憶が切れます。書き込みツールを有効にしていれば、アシスタントがそこへ事実を残すことを提案することもでき、ほかの書き込みと同じくあなたの承認を待ちます。

フォルダーを要約する。ワークスペース全体でも、任意のサブフォルダーでもかまいません。エクスプローラーでフォルダーを右クリックし、AI で要約… を選びます。費用が発生する前に、読むノートの件数と AI 呼び出しの回数（いずれもプロバイダーの課金対象）が示され、形式を選べます。概観 は続き物の文章、知識をまとめる は決定事項・未処理・アイデア・矛盾・未解決の疑問という固定の見出し付きです（内容のない見出しは、作り話で埋めずに省かれます）。費用の上限に収まらないほどノートが多い場合は、何件が対象外になったかが示されます。最後に ノートとして保存 を押すと、要約したフォルダーの中に要約が書き込まれます。見出しには日付とノート件数が入り、以前の要約を上書きすることはありません。

HTTP API のテスト（.lnh）

ツール → 新しい API テスト（.lnh）…は、.lnh ファイルに保存される HTTP クライアントを開きます。1 つのファイルが 1 つのエンドポイント（メソッド・URL・ヘッダー・ ボディ）を表し、左の一覧に複数のテストを保持します。各テストは、URL・ヘッダー・ボディで 使う {name} 変数の値に加え、最後の実行結果（ステータス・時間・日付・レスポンス ヘッダーとボディ）を持ちます。同等の curl コマンドも表示します。同じ単発操作は CLI（http）と MCP（http_request）でも利用できます。

Ctrl+Enter でリクエストを送信します。

OpenAPI のインポートとエクスポート。 テスト一覧の上部にある矢印ボタンから OpenAPI をインポート… と OpenAPI をエクスポート… を開けます。インポートは YAML または JSON の仕様を読み込み、現在使われている 3 世代 — Swagger 2.0、 OpenAPI 3.0、3.1 — に対応して、テストを自動的に組み立てます。パスの {parameters} は .lnh の {name} 変数と同じ記法なので そのまま使え、仕様に宣言された例はテストの値になり、セキュリティスキームは Authorization ヘッダーになり、宣言された各サーバーはそれぞれ 1 つのテストになります （検証環境と本番環境を並べて持てます）。.lnh は 1 つのエンドポイントを保持する ため、操作が複数ある仕様ではどれをインポートするか尋ねます。すべてを一度に保存して、 操作ごとに .lnh ファイルを 1 つずつ作ることもできます。

エクスポートはその逆で、ファイルから OpenAPI 3.0.3 の仕様を生成します。サーバー、パラメーター、 本文はテンプレートから、応答の例は記録された実行から作られます。これは骨組みであって完全な 契約ではありません。.lnh は呼び出しを記述するものなので、型・説明・スキーマは復元 されません。テストは x-lightnote-tests フィールドに一緒に入るため、ファイルを 再インポートすればそのまま戻ります。

curl コマンドのインポート。 同じボタンの curl コマンドをインポート… で貼り付け用のボックスが開きます。コマンドはディスクではなくそこから来るもので、クリップボードに curl がある場合は最初から入力されています。同じコマンドが流通する 3 つの方言に対応 します。Chrome/Firefox のcURL としてコピー（単一引用符）、Windows の Copy as cURL (cmd)（^ を使う形式）、そして \ で折り返されたドキュメントの例です。 メソッドは -X から取り、指定がなければ本文があれば POST、なければ GET と判断します。

インポートはそのまま行われます。どの値も自動では {name} 変数になりません。 どのトークンが秘密情報かを推測すると間違えるからです。いくつかの場合は偽らずに警告します。ファイル から読む本文（-d @ファイル）は読み取れず、マルチパート送信（-F）も忠実 には再現できないため、項目は調整できるようテキストとして本文に入ります。

データベース（.lnc）

接続

接続は、ワークスペース内の .lnc ファイル（LightNote Connection）です。 Git でバージョン管理でき、マシン間で持ち運べます。新規 → 新しい接続で作成するか、 既存の .lnc を開きます。これによりデータベースビューが開き、接続ステータス バー（接続 / 切断 / 再接続 / 編集）、スキーマツリー（スキーマ → テーブル → 列、 オンデマンドで読み込み）、内部の .sql タブが表示されます。開いていた .sql ファイルと最近の項目は .lnc の内部に保存されるため、 ビューは前の状態で再び開きます。何も開いていなかった場合は、すぐに SQL を入力できる 空（無題）のクエリで始まります。保存時（Ctrl+S）には、LightNote は名前だけ を尋ね、ファイルをプロジェクトフォルダー内に書き込みます（「どこにでも保存」ダイアログは ありません）。+ タブボタンは新しい空のクエリを開くか、ファイルを開く（ピッカーは プロジェクトフォルダーで開く）、または最近の項目やプロジェクトフォルダーの任意の .sql を選べます。

ツリーから直接開いた .sql はコードのみです（SQL ハイライト、接続なし）。

ドライバー: SQLite と DuckDB（ファイル）はネイティブ。PostgreSQL、MySQL/MariaDB、 SQL Server、汎用は ODBC 経由。ネイティブ Oracle（ODBC なし）。 SQL Server は Microsoft の msodbcsql ドライバーを使い（マシンにインストールしてください）、 Windows 認証またはユーザー/パスワードに加え、チャネルの暗号化オプション （Encrypt / 証明書を信頼）を提供します。Oracle では 全般設定 → データベースで Oracle Instant Client のフォルダーを設定してください — 実行時に読み込まれ、 インストールは不要です。Oracle 接続には 4 つのモードがあります: サービス名 （ホスト/ポート/サービス）、SID（ホスト/ポート/SID）、TNS 名 （クライアントフォルダーの tnsnames.ora のエイリアス）、完全な TNS 記述子 （テキスト欄に貼り付け）。

パスワード: パスワードを保存をオンにすると、.lnc 自体の中で 暗号化します（移植可能な暗号で、別のマシンでも開けます）。オフの場合、パスワードは保存されず、 接続のたびに尋ねられます。暗号化にはワークスペースごとのセキュアフレーズを使い、 ヘルプ → セキュアフレーズの設定で設定します。大切に保管してください — それがないと、 他のどこでもパスワードを開けません。セキュアフレーズはローカルマシンにのみキャッシュされます （Git には決して送られません）。

開いたときに接続をオンにすると、.lnc を開いたときに接続が自動的に開きます。 自動接続は静かに行われます。パスワードの入力が必要な場合（尋ねるモード、またはマシンに セキュアフレーズがキャッシュされていない暗号化）は、ファイルは中断せず未接続で開きます。

実行と結果の表示

実行: Ctrl+Enter はカーソル位置の文を、Alt+X はスクリプト全体を実行します。 結果はページングされて表示され、それぞれ結果タブに下部のアクションバーが付きます: 次のブロックを取得、結果を固定、総件数、行の上限の変更、 更新（再実行）、SQL を表示/コピー、エクスポート...、選択した行から SQL を生成。

結果を固定: 結果全体をデータベースから一度に読み込み、ローカルのテーブルに保存します （メモリに収まらない場合はディスクに保存されます）。以降、グリッドはデータベースに問い合わせずに スクロールし、行数は正確になり（総件数は不要）、見出しをクリックすると並べ替えができ（もう一度クリックすると降順、3 回目でデータベースが返した順に戻ります）、 エクスポートもローカルのコピーから行われます。見出しによる並べ替えが使えるのは 10 万行までです。それを超えると拒否され、理由は見出しのツールチップに出ます。ページごとにコピー全体を並べ替え直すことになり、グリッドを見て回るのにまた数分かかるためです。 最初のページで結果全体が届いている場合は、固定しなくても並べ替えられます。行がすでにメモリにあるからです。並べ替えられないのは、まだページ送りの途中である結果の最初の一部です。見出しが、画面にある分だけに当てはまる順序を主張することになるためです。グラフとピボットテーブルは結果 全体を対象にします — グラフが使えなかったデータベースでも同じです。途中で止まった場合 （停止を押した、または上限に達した場合）、行はローカルのままですが、グラフとピボットテーブル はサーバー側に残ります。結果の一部を集計すると誤った数値になるためです。また、この状態でグリッドを並べ替えても、対象は取得済みの行だけで、結果全体ではありません。更新すると固定が 解除され、クエリが再実行されます。 固定するかどうかに関係なく、いったんグリッドを通ったページはローカルに保持されます。そこへ戻ってスクロールしても、データベースには問い合わせません。 固定処理は同時に一つだけです。結果が二つ開いているとき、もう一方で結果を固定を押すと理由とともに拒否され、進行中の処理は中断されません。止めるには、その処理のタブで停止を使ってください。

結果グリッド: NULL は空文字列と区別して淡いイタリックで表示され、数値は右揃えに なります。複数のセルを選択すると、フッターに選択の件数が表示され、数値の場合は合計と平均も 表示されます。フッターバーの値パネルボタン（またはコンテキストメニューのパネルで値を表示） を押すと、選択したセルの完全な値を省略せずに表示するサイドパネルが開き、整形ボタンで JSON/XML を表示上だけ整形できます。セルのコンテキストメニューでは、この値で絞り込む / この値を除外がセルの値で WHERE を付けて再実行し、参照先レコードへ移動は 列の外部キーをたどって親テーブルをセルの値で照会します。

グラフとピボットテーブル: 集計がどこで行われるか。 グリッドのフッターに ローカルデータ と テーブル全体（サーバー上） を切り替えるセレクターがあり、ボタンに現在有効な方が表示されます。結果が最初のページにすべて収まった場合の既定はローカルです。LightNote は画面に表示済みの結果を集計するため、軸・集計方法・区間を変えるたびにデータベースへ問い合わせ直しません。ローカルのエンジンは DuckDB なので、グラフは Oracle・SQL Server・PostgreSQL・MySQL でも使えるようになります（これらのサーバーではグラフの SQL が実行できません）。結果が切り詰められた場合、ローカルの選択肢は理由付きで使用できなくなります。標本を集計すると誤った数値になり、切り詰めを知らせるだけでは誰も守れないからです。グラフで読み取るのは棒の高さです。サーバーの選択肢はクエリ全体を集計し、調整のたびにクエリが 1 回実行されます。データベースが文字列として返す数値列（Oracle の NUMBER がその例）は数値として認識されますが、01310 のように先頭が 0 の識別子は文字列のままです。

実行計画: ツールバーの実行計画ボタンは、カーソル位置の文の EXPLAIN を 表示します（SQLite、DuckDB、PostgreSQL、MySQL）。単一の文で計画を提供しないデータベース（SQL Server、 Oracle）ではボタンは無効になり、理由がツールチップに表示されます。

スキーマ

オブジェクトのプロパティ: スキーマツリーでテーブルをダブルクリックする （または F4、コンテキストメニューのプロパティ）と、オブジェクトの構造が 4 つの サブタブで開きます: 列（番号・名前・型・NULL 可否・既定値、主キー列にはキーアイコン）、 キー（主キー・外部キー・一意・チェック制約。外部キーをダブルクリックすると参照先テーブル が開きます）、インデックス、DDL — オブジェクトの CREATE TABLE で、 コピー・.sql として保存・編集可能なタブで開くことができます。データベースが DDL を直接提供しない場合（PostgreSQL と SQL Server にはそのコマンドがありません）、LightNote は メタデータから再構築します（DDL コマンドが権限不足で拒否された場合も同じです）。その旨は タブに明示されます。列のカタログさえ読み取れない場合（権限がない、カタログが利用できない）は 再構築の材料がありません。タブは黙って空になるのではなく、その理由を表示します。テーブルのコンテキストメニューにはタブを 開かずに DDL をコピーする項目もあります。

スキーマツリー: スキーマツリーはテーブルとビューを（それぞれ独自の アイコンで）分け、主キーを構成する列にキーアイコンを付けます。フィルターボックスはすでに読み込 まれたオブジェクトだけを絞り込みます（絞り込みのためだけに遅延読み込みは強制されません）。

スキーマの探索: テーブルを右クリックすると SELECT をエディターに挿入、データを表示、行数を数える、 修飾名をコピー、または SQL を生成サブメニュー → INSERT/UPDATE/MERGE を開けます。画面にテーブルの列が一覧表示され、含めると キーをチェックでき、ライブプレビューを表示してコマンドをエディターに挿入します （MERGE は ANSI で出力され、ドライバーが対応していない場合は警告が表示されます）。 結果グリッド上では、下部バーの SQL を生成ボタンが選択した行の値で INSERT/UPDATE/DELETE を生成します（クエリが単一テーブルの SELECT の 場合に利用可能）。ツリーで参照したテーブル名と列名は、接続の .sql エディターの 自動補完（Ctrl+Space）にも表示され始めます（追加のデータベースクエリは 行いません）。

エクスポート・変数・トランザクション

結果のエクスポート: 結果グリッドを右クリックして結果をエクスポート...を選ぶと、 CSV（区切り文字・引用符文字・常に引用符で囲む・見出し行・NULL の表記）、 JSON Lines、SQL（テーブル名付きの INSERT 文）を、任意の行数上限付きで 書き出せます。エクスポートは画面に見えている分だけでなく、クエリ全体をストリーミング （ページングして再取得）で走査します。

スクリプト変数: スクリプトの行で @set 名前 = 値 を使って変数を定義します。 @ の接頭辞によりデータベースに送られません（Postgres/DuckDB/SQL Server の実際の SET と衝突しません）。:名前 のような参照は実行前に置換されます （文字列やコメントの外。::型 のキャストや :1 のようなバインドは そのまま）。値のない :名前 は実行前にプロンプトを開きます。ツールバーの 変数ボタンは、定義された変数の画面を開きます（編集/追加/削除）。

クエリ履歴: 履歴ボタンは、この接続で正常に実行された直近の文を SQL / 実行日時 / 所要時間 / 行数の列で表示するウィンドウを開きます。選んで再実行、 エディターに挿入、コピー（ダブルクリックで挿入）でき、履歴をクリアもできます。 ローカルマシンにのみ保存されます（Git にも .lnc にも送られません）。

トランザクション: 自動コミットボタン（既定でオン）と Commit/Rollback ボタンがツールバーにあります。自動コミットがオフの場合、変更は確定（Commit）または破棄 （Rollback）するまで保留されます。トランザクションを開いたまま切断すると、どうするか 尋ねられます。

SSH 接続（.lns）

SSH 接続は、ワークスペース内の .lns ファイルです — .lnc と同様に バージョン管理でき、持ち運べます。新規 → 新しい SSH 接続で作成すると、統合 SSH ターミナル（Windows の ssh.exe 経由）とリモートファイルミニバー （SFTP）がタブに開きます。

ファイルブラウザーは一度に 1 つのフォルダーを表示します（MobaXterm/WinSCP 風）。 最初の行は常に上の階層へ移動する .. で、フォルダーをダブルクリックすると中に入ります。 上部のパスバーでリモートパスを入力し Enter を押すとそこへ移動します。 ターミナルと同期ボタンは、表示されるフォルダーを SSH セッションの現在のディレクトリに 追従させます（ターミナルで cd した先）。右クリックメニューにはエディターで開く （ファイルをダウンロードし、タブで開き、保存時に再アップロード）、ダウンロード、 アップロード、新しいフォルダー、名前を変更、削除、権限（chmod）が あります。エクスプローラーからファイルをドラッグしてパネルに乗せると、現在のフォルダーに アップロードできます。

パスワードは、ワークスペースのセキュアフレーズで .lns 内に暗号化するか、接続のたびに尋ねることができます。接続には システムの OpenSSH クライアントを使うため、Windows のエージェント/プロファイルの SSH 鍵は 通常どおり動作します。

開いたときに接続オプション（接続ダイアログ内）は、.lns を開いたときに SSH セッションを自動的に開始します。パスワードが保存されていない場合は、接続時にターミナル自身が 尋ねます。

セキュリティ: セキュアフレーズ・PIN・セキュア Markdown

セキュアフレーズはワークスペースごとに ヘルプ → セキュアフレーズの設定…で設定し、 LightNote が暗号化するすべての鍵になります: 接続パスワード（.lnc/.lns）、 カスタムテーブルのパスワードセル、.lne ファイル。 暗号化は強力で移植可能です（Argon2id + XChaCha20-Poly1305）: 暗号化されたファイルは、 同じセキュアフレーズを再入力すれば別のマシンでも開けます。大切に保管してください: それがないと、暗号化されたデータは復元できません。セキュアフレーズはローカルマシンにのみ キャッシュされます（Git には決して送られません）。

セキュアフレーズを変更するには、同じ画面を開いてセキュアフレーズ欄を編集します （現在のものが入った状態で表示されます）。確定すると、LightNote はワークスペースのすべての セキュアデータ — .lnc/.lns のパスワード、.lne ファイルの 内容、カスタムテーブル（.lnd）のパスワードセル — を、古いセキュアフレーズから 新しいものへ自動的に再暗号化します。復号は全か無かです: 1 つでも復号に失敗すると、 何も変更されず、LightNote がどれか教えてくれます。書き込み中は、各ファイルは書き換える前に バックアップにコピーされます。1 つが書き込みに失敗した場合、すべて元に戻す（バックアップを 復元）か、そのファイルをスキップして続行（古いフレーズのまま、最後に警告）するかを尋ねます。 （「尋ねる」モードのパスワードには再暗号化するものがありません。）

PIN（4〜8 桁）は任意のローカルロックです: 毎回セキュアフレーズを入力せずに、機密性の高い UI 操作（パスワードの表示、セキュアノートを開く）を保護します。何も暗号化せず、このマシンにのみ 適用されます。

セキュア Markdown ファイル（.lne、新規 → セキュア Markdown ファイル）は、 ディスク上で暗号化されたノートです: 開くとき、LightNote は PIN（設定されている場合）と セキュアフレーズを尋ね、メモリ上でのみ復号し、保存時（Ctrl+S）に再暗号化します。 安全のため、セッションが復元されても自動的には再び開きません。それ以外は ほかのノートと同じノートです: AI アシスタント（Ctrl+K/Ctrl+I とバーの AI ボタン）、ウィキリンクとタグの Ctrl+クリック、リンクを開くこと、ステータスバーのアドレス表示が使えます。AI について覚えておくこと: 選んだアシスタントがクラウドのサービスなら、送った断片はマシンの外に出ます。ローカルのモデル（Ollama、LM Studio）なら出ません。またセキュアなノートは ノートに質問 の対象外のままです — あちらはワークスペースの .md を読みますが、ディスク上の .lne は暗号化されたテキストだからです。

デイリーノート・クイックキャプチャ・トレイ

今日のノートは、デイリーノートフォルダー内の 1 日 1 つの .md です。 このフォルダーは LightNote 全体で共通の 1 つで、設定 → ノートと執筆で指定します。トレイメニューから: 今日のノートはその日のノートを開きます。クイックキャプチャ… （Ctrl+Alt+N、グローバルな Windows ショートカット — またはトレイアイコンを 中クリック）は小さなウィンドウを開き、入力して Ctrl+Enter を押すと: テキストが タイムスタンプ付きの箇条書きとして今日のノートに、エディターウィンドウを開かず直接ディスクに 書き込まれます。

トレイメニューには開いているウィンドウと最近のワークスペースも表示され、電源の トグルが備わっています: コンピューターをスリープさせないと画面をオンのままにする （長時間のタスクに便利。LightNote はワンショット AI・ブロックのセル・SQL スクリプトの実行中は 自動で電源を保持します）。ランチャー（開始ウィンドウ）には検索、ダブルクリックで開く、 上部にピン留め・エクスプローラーで開く・一覧から削除のコンテキストメニューがあります。

LightNote 全体に効く操作は — 今いるウィンドウだけの操作ではないため — 全般メニュー（☰ 全般、またはアクティビティバーのアプリアイコンのボタン）にまとまっています。この menu は通知領域メニューとまったく同じ形です: ルートに今日のノート、クイックキャプチャ、カレンダー。続いてサブメニューのキャプチャ（クイックタスク、音声録音、古いノートの再発見、付箋）、開く（ランチャー、ワークスペースを開く、単独ファイルを開く、単独ファイル）、電源。最後に全般設定。ルールは単純です: 通知領域メニューにあるものは全般メニューにある — そこにだけあります。項目にマウスを合わせると「全般機能: どのウィンドウでも LightNote 全体に適用されます」と表示されます。

キャプチャの保存先。 デイリーノートとクイックタスクの保存先はひとつに決まっていて予測できます: 設定 → ノートと執筆で指定したフォルダーと、設定 → 全般で指定したボードで、どのウィンドウでも同じです。何も指定がない状態で最初にキャプチャすると、LightNote が保存先を尋ねてその選択を記録します — 設定画面を探しに行かせることはありません。独自の日誌が必要なプロジェクト（守秘義務のある顧客、リポジトリに置くべき記録など）は、ワークスペース設定 → キャプチャでそのウィンドウのキャプチャを引き受けられます。通知領域とグローバルショートカットは引き続き全般の保存先に書き込みます。確認通知には必ず保存先が表示されます。

タスクトレイのメニューは意図的に短くしてあります。ルートに残るのは開いているウィンドウと、毎日使う 3 つの操作 — 今日のノート、クイックキャプチャ、カレンダー — だけです。ほかは全般メニューと同じサブメニューにまとめてあります: キャプチャ、開く（トレイでは最近使ったワークスペースの一覧も含みます）、AI（AI セッション、AI チャット — ウィンドウでは完全な AI メニュー）、電源。最後に設定と終了。

古いメモを再発見

「第二の脳」が失敗する最大の原因は、機能の不足ではなく、二度と読み返されないメモです。トレイメニュー（キャプチャセクション）から、LightNote は古いメモを呼び戻します。ランダムなメモはワークスペースの .md メモをランダムに開き（直近 2 週間に表示したものは避けます）、この日は作成の記念日が今日（過去の年の同じ月日）のメモを一覧します。どちらの操作もウィンドウの全般 → キャプチャメニューにもあります。

作成日は frontmatter の created/date フィールドがあればそこから、なければファイルの日付から取得します。この機能はメモに書き込むことはありません — 開くだけです。設定 → 機能（「古いメモを再発見」）でオフにできます。

スマートフォンでのノート

あなたの空間（ワークスペース）はフォルダー内のプレーンな Markdown です。オープンな形式で、専用のデータベースも必須のクラウドもありません。そのため どのスマートフォンアプリでもノートを読み書きでき、LightNote が電話用の専用アプリを用意する必要はありません。フォルダーを同期してスマートフォンの Markdown エディターで開くだけです。

手順：ワークスペースのフォルダーを OneDrive、Google Drive、Dropbox、または Syncthing で同期し、スマートフォンでそのフォルダーを Markdown エディター（例：Obsidian Mobile、iA Writer、GitJournal、Markor）で開きます。すべてがテキストの .md なので、両方の側から同じノートを見て編集できます。

おすすめ：スマートフォンでは .md ファイルのみを編集してください。LightNote 独自の形式（安全な .lne、.lnc、.lnt、.lnb、.lnd など）はアプリの外では開けず、特に .lne は暗号化されています。両方の側がオフラインで編集して 競合が起きた場合は、Inbox フォルダーで解決してください。キャプチャ（テキスト・音声・写真）をそこに置き、上書きするのではなく LightNote にその日のノートへ統合させます。この設計は意図的です。同期はファイル／Git で行い、プラグインでは行いません。データはあなたのもので、転送方法もあなたが選びます。今日のノートに直接書きたい場合は、デイリーノート/yyyy-mm-dd.md というファイルを編集してください（フォルダー名は言語によって変わります）。

音声を録音（メモ・会議）して AI で文字起こし

トレイメニューの 音声を録音… でフローティングのドラッグ可能なウィンドウが開き（タイトルバーをドラッグ)、マイク、システム音声（コンピューターで再生中の音)、または両方を同時に録音できます。選んだ入力元は次回のために記憶されます。● 録音、‖ 一時停止、■ 停止を使い、ファイルはワークスペースの 録音 フォルダーに保存され、停止時に .m4a に圧縮されます。

2 つの文字起こし方式。 設定 → AI アシスタント → 音声の文字起こし の 文字起こしの方法 で、専用の文字起こしモデル（Whisper 方式: OpenAI whisper-1、Groq whisper-large-v3（無料）、またはローカルの Whisper）と、チャットに音声を渡す汎用モデルを選べます。後者は音声をマルチモーダルモデルの会話に入れる方式で、Google Gemini（gemini-2.0-flash、無料枠が充実）はこの方式で文字起こしします。プロバイダーを切り替えると適切なモードが事前選択され、モデルが提案されます。長い音声はどちらのモードでも自動的に分割されます。提案されたモデルは手入力で変更でき、LightNote はまだ認識していないプロバイダーでも入力した ID を尊重します。

録音を始めると、ウィンドウは自動的にコンパクトなピル状（点滅する赤いドット、タイマー、一時停止/停止）に折りたたまれます。会議中は隅にドラッグしてほぼ隠しておけます。タイトルの最小化/展開ボタンで手動でも切り替えられ、停止すると自動的に元の大きさに戻ります。Ctrl+Alt+R（グローバルショートカット）はすぐに使える音声メモ用です。押すとマイクからすぐ録音を始め、もう一度押すと停止します。マウスでウィンドウを開く必要はありません。

API 方式の AI プロバイダーを設定してあると（設定 → AI アシスタント → 音声の文字起こし）、停止時に 文字起こし と 文字起こし + 要約 のボタンが現れます（音声がまだ圧縮中は無効）。停止時のコンボで、録音が終わると同時に自動で文字起こしを始めることもできます。LightNote は音声を送って文字起こしし（Whisper 系モデル）、音声の隣に本文（必要なら要約も）を書いた .md ノートを作成します。この機能は 設定 → 一般 → 機能 でオン/オフできます。

同じウィンドウはミニプレーヤーでもあります。コントロールの下に、フォルダー内の録音一覧が表示され、各ファイルには（存在する場合）T（文字起こしを開く）とR（要約を開く）のボタン、その場で再生する▶（シーク付きの進捗バー）が並びます。各行の⋮メニューから再生・（再）文字起こし・ノートを開けます。文字起こしを再生成しても前のものは上書きされず、隣に新しいバージョン（note.md、note (2).md…）が作成され、履歴が残ります。録音のソースはメニューボタン（マイク／システム音声／両方）で、既定は両方です。録音フォルダーを開くリンクでメインウィンドウにフォルダーを開きます。

付箋

付箋は、デスクトップ上に浮かぶ小さな色付きの平文ボックスで、Windows の付箋 アプリのスタイルです。トレイメニューから: 新しい付箋（Ctrl+Alt+S、 グローバルショートカット）がボックスを作成し、付箋を表示（Ctrl+Alt+H）が すべてをまとめて表示/非表示します。各ノートにはもう 1 つ作る + と、色の変更・ 今日のノートに送る（テキストを今日のノートの箇条書きとして書き、ボックスを破棄）・ 削除の ☰ メニューがあります。ヘッダーをドラッグで移動、隅のグリップでサイズ変更 します。ノートは自動的に保存され、LightNote を再び開くと再表示されます。

チェックリスト。 ヘッダーのリストボタン（+ の隣）を押すと、カーソルのある行（または選択した行）がチェックボックス付きの項目になり、もう一度押すと元に戻ります。行頭で [ ] と入力してスペースを押しても作成できます（[x] ならチェック済みの項目になります）。チェックボックスをクリックするか Ctrl+Shift+Enter を押すと、チェックを付けたり外したりでき、完了した項目には取り消し線が付きます。Enter で次の項目を作成し、空の項目で Enter を押すか項目の先頭で Backspace を押すと通常のテキストに戻ります。ノートのメニューの 完了した項目を削除 は、チェック済みの項目をまとめて削除します（Ctrl+Z で元に戻せます）。項目は Markdown のタスク（- [ ] 項目）として保存されるため、今日のノートに送る では各項目がタスクとして送られます。

カレンダー

全般 → カレンダー…は、登録されたすべての .lnt ボードの タスクを持つ日をマークするカレンダーを 1 つのウィンドウで開きます。その横に、今日の リスト（選択した日のタスク）と未対応のリストがあります。今日のノートボタンは その日付のデイリーノートを開きます。タスクをクリックすると対応するボードが開きます。

グリッドでは、タスクのある日にカンバンのステータス色のドット（最大 3 個）が付き、今日はリング、選択中の日は塗りつぶしの円で示されます。今日で今月に戻り、月名をクリックすると月や年を切り替えるメニューが開きます。未対応は状況別に 期限切れ・今日・今後 7 日間・それ以降・期日なし にまとまり、期限は「昨日」「今日」「3 日前」のような相対表示のバッジで示されます。日付をダブルクリックすると、その日付が入ったクイックタスクが開きます。

ノートに書いたタスクもここに出ます。ノートの - [ ] はほかと同じタスクで、未完了に、ボードのカードと並んで同じグループに入るようになりました。行に日付（明日、金曜、08/12）が書かれていれば、正しいグループと正しい日に入ります。ダブルクリックすると、そのチェックボックスの行でノートが開きます — タスクを直す場所はノートのままです。走査は裏で動きます。ウィンドウはボードとともにすぐ開き、ノートのタスクは少し遅れて届きます。グリッドでは、その日にすでに日次ノートがある場合、日付の数字に下線が付きます。日ごとの一覧には この日 も出ます。過去の年の同じ日付に書いたノートです。

コマンドパレット

Ctrl+Shift+P はコマンドパレットを開きます（各操作とそのショートカット、 入力で絞り込み可能）。Ctrl+R はクイックファイルピッカーを、Ctrl+Shift+K は タスクピッカーを開きます。

MCP サーバー（AI エージェント）

LightNote にはヘッドレスの MCP（Model Context Protocol）サーバーが含まれ、 ワークスペースを AI エージェント向けのツールに変えます（Claude Desktop、 Claude Code、Cursor、および MCP を話すあらゆるクライアント）。エージェントは ファイルの読み書き、検索、表形式データとデータベースのクエリ、タスクの操作、Git の 利用、HTTP リクエストの発行ができます — すべてフォルダーに限定されます （ディレクトリジェイル: .. を含む、あるいはルート外のパスは拒否）。 トランスポートは stdin/stdout 上の JSON-RPC 2.0 で、セッションごとに軽量な lnote.exe プロセスが起動し、エディターのウィンドウとは別になります。

ワンクリックのショートカット： AI → このフォルダーで AI を有効にする を選ぶと、LightNote は MCP を有効にして .mcp.json を一度に書き込みます（クリックが同意になります）。フォルダーで AI が既に有効な場合、この項目は このフォルダーの AI を設定… になり、ワークスペースの設定 を開きます。

2層のセキュリティ:（1）サーバーはそのフォルダーでオプトインして いる場合のみ起動します。（2）すべてのツールはワークスペースのルートに固定されます。 さらに、各ツールには注釈（読み取り専用・破壊的・冪等・「外部世界に触れる」） が付き、AI クライアントは呼び出す前にリスクを評価できます。

設定の手順

  1. フォルダーで MCP を有効にする。ツール → ワークスペースの設定で このワークスペースで MCP を有効にするをチェックします。このオプトインが ないとサーバーは起動を拒否します（これが主要なゲートです）。あるいはコマンド ラインから: lnote --mcp-enable "C:\Path\to\workspace" （オフにするには --mcp-disable）。
  2. lnote.exe のパスを見つける。これは lightnote.exe と同じフォルダー（アプリのインストールフォルダー）にあります。UI を持たない 「slim」なコンソール実行ファイルで、エージェントが実行するのはこれです。
  3. AI クライアントにサーバーを登録する。コマンドを lnote.exe に向け、--mcp の後にワークスペースのフォルダーを渡します。Claude Desktop / Cursor などが使う形式で:
{
  "mcpServers": {
    "lightnote": {
      "command": "C:\\Path\\to\\lnote.exe",
      "args": ["--mcp", "C:\\Path\\to\\workspace"]
    }
  }
}

設定のヒント:

  • JSON 内のバックスラッシュは例のように二重にする必要があります （C:\\Users\\...\\lnote.exe）。
  • 複数のワークスペースを公開するには、フォルダーごとに別々の名前で エントリを追加します（"lightnote-projectA"、 "lightnote-projectB"）。それぞれ自分のルートを指します。
  • 設定を保存したら、AI クライアントを再起動してサーバーを起動させます。 接続すると、エージェントは lightnote_* ツールを一覧するはずです。 「ワークスペースのファイルを一覧して」と頼んで動作を確認しましょう。
  • Claude Code（CLI）では、同じサーバーを次のように登録できます: claude mcp add lightnote -- "C:\Path\to\lnote.exe" --mcp "C:\Path\to\workspace"。

データベースのパスワード（任意）。db_query ツールは .lnc 接続を開きます。パスワードがセキュアフレーズで暗号化されている 場合は、サーバーブロックの環境変数 LNOTE_PASSPHRASE でフレーズを渡します （コマンドライン引数では決して渡さないこと）。パスワードが「尋ねる」モードの接続は 無人では使えません。

AI によるクエリは接続ごとのオプトインです。フォルダーで MCP を有効にしても接続は公開されません。各 .lnc は、接続ダイアログで 「AI によるクエリを許可 (MCP)」 がオンのときだけ db_query に応答します。アクセスは読み取り専用（SELECT）です。

エージェントによるデータベースからのエクスポート。 クエリだけでなく、db_export で SELECT をファイルに実体化できます（Parquet、CSV、JSON、.xlsx）—応答に収まらない大きな結果に便利です。同じ 3 つの安全策がこの順で適用されます：クエリは読み取り専用、接続には 「AI による照会を許可 (MCP)」 のオプトインが必要（パスワードを復号する前に確認）、出力先はワークスペースの内側。大きなエクスポートはシステムの一時フォルダーを作業領域として使い、おおむね結果と同じ容量を消費します—ディスクの空き容量を確保してください。

利用できるツール

エージェントはクライアントのプレフィックス付きでツールを見ます（例: lightnote_read_file）。カテゴリ別:

  • ファイル: read_file（行範囲は任意）、write_file、 edit_file（ファイル全体を書き換えずに正確なスニペットを置換）、 append_file、list_files、move_file、 make_dir、delete_file（ごみ箱へ。完全削除では ありません）。
  • 検索とナビゲーション: search_files（ripgrep。サブフォルダー /glob フィルターと上限付き）、list_symbols（ファイルの関数/クラスの アウトライン）、open_in_editor（LightNote のウィンドウが開いていれば ファイルを開く/フォーカス）。
  • データと SQL: query（Parquet/CSV/JSON 上の DuckDB SQL、tsv/json/markdown 出力）、describe_table（スキーマ + 統計、行は 出さない）、export_query（SELECT を COPY でファイルに 実体化）、sqlite_query（.sqlite/.db 上の SQL）、db_list_connections（ワークスペースの .lnc を 一覧）、db_query（.lnc 接続上の読み取り専用 SQL）。 結果を応答ではなくファイルに出力するには db_export（Parquet/CSV/JSON/.xlsx）。
  • さらに: search_notes（質問に対して最も関連性の高いノートの抜粋を取得 — AI チャットと同じエンジン）、list_links（ノートの発リンクを、解決済みか壊れているかで表示）、audit_vault_links（保管庫全体の壊れたリンクと孤立ノート）、list_note_templates と create_note の template パラメータ、list_due_tasks（全プロジェクトで今日締切または期限切れのタスク）、xlsx_read（.xlsx シートを TSV として読み取り）、data_diff（2つの表形式ファイルを比較）、そしてデータベースのカタログ db_list_objects/db_describe（テーブル／ビューと、テーブルの列・キー・DDL — db_query と同じ条件）。さらに note_export（ノートを docx、odt、epub、LaTeX、Typst、HTML、reStructuredText、AsciiDoc、Org、MediaWiki、Notebook、あるいは別の方言の Markdown に書き出し —— ウィンドウなしで、lnote note-export からも）。そして note_import（逆方向：docx、odt、epub、rtf、HTML、tex を、見出し・リスト・表・強調・リンク・数式・画像ごと、元ファイルの隣にノートとして取り込み —— lnote note-import からも）。 そして folder_export（フォルダーごと HTML サイト・文書のセット・Markdown になり、リンクも書き換えられます —— lnote folder-export からも）。
  • 圧縮ファイル: zip_list（.zip/.isx のメンバーを一覧）と zip_read（メンバーをテキストとして読む）— ディスクに展開せずに読み取ります。
  • タスク: list_task_projects（ワークスペースの .lnt タスクプロジェクトを一覧）、list_tasks、 list_task_statuses（ボードの列）、create_task、 update_task、update_task_status（列を移動）、 delete_task、task_note（タスクの .md ノートの読み書き）。1 つのワークスペースに .lnt プロジェクトが複数あってもよく、project パラメーター（list_task_projects が返す name。1 つだけなら省略可）でどれを操作するか選びます。id/status_id はセッション内の識別子です。取得のために .lnt の内部ファイルを読まず、タスクツールを使ってください。
  • ノート（PKM）: create_note（.md ノートを作成）、 append_daily_note（今日のノートにキャプチャを追記）、 remember (あなたについての持続的な事実を記憶ノートに保存), list_backlinks（あるノートを参照しているノート）、 list_note_tags と search_by_tag（vault の #ハッシュタグ とそれを使うノート）、add_task （期限・タグ付きのタスクを作成。タイトルに自然言語を受け付けます）。
  • Git: git_status、git_log、 git_diff、git_restore。
  • Web と通知: http_request（HTTP リクエストを発行して ステータス/ヘッダー/本文を返す）、notify（開いているウィンドウの トレイに通知を表示 — エージェントが完了を知らせるのに便利）。
  • AI プロキシ: list_ai_models と ask_ai （下記）。

サーバーはワークスペースのファイルを MCP のリソースとしても公開します （resources/list と resources/read）。read_file を呼ぶ代わりにファイルを「添付」したいクライアント向けです。

あなたのプロンプトライブラリ（ワークスペースの Prompts/ フォルダー）は MCP のプロンプトとして公開されます（prompts/list と prompts/get）。Claude Code では各プロンプトがスラッシュコマンド /mcp__lightnote__<名前> になり、AI CLI 内ですぐ使えます。

書き込みのセーフティネット。 ファイルを上書き（write_file/edit_file）または削除（delete_file）する前に、サーバーは以前のバージョンをローカル履歴（エディタと同じセーフティネット）に保存します。Git リポジトリの外でも、エージェントが行った変更を元に戻せます。

各ツールは読み取りか書き込みかを明示します。MCP のアノテーション （readOnlyHint/destructiveHint）に加えて、説明の先頭に [read-only]・[writes]・[destructive] のバッジが付きます。許可リストを安全に組むのに便利です。

AI プロキシ（別のモデルに委譲）

MCP 列にチェックして登録した API プロバイダーは、2つの ツールでエージェントに公開されます: list_ai_models（許可されたモデルを id・名前・モデルで一覧）と ask_ai（{model, prompt}）。これに より、メインのエージェントはサブタスクをより安価または専門的なモデルに 委譲できます。呼び出しは起動中の LightNote が仲介します（MCP の lnote.exe が内部ブリッジ経由でアプリのウィンドウに要求を転送）: API キーはコンピューターから決して出ず、エージェントにも届きません。 LightNote が開いていない場合、ツールは開くよう促すエラーを返します。

コマンドライン（lnote）

同じ MCP 操作は、スクリプトと自動化のためのコンソール実行ファイル lnote にもあります （lightnote cli <command> としても到達可能）。すべての操作はルートフォルダーに 限定され、--root で設定します（既定: 現在のフォルダー）。

例:

lnote list --recursive
lnote read --path src/main.cpp --start-line 1 --end-line 40
lnote write --path note.md --content "Hello"
echo content | lnote write --path note.md --content -
lnote search --query TODO --regex
lnote query --sql "SELECT * FROM read_parquet('data.parquet') LIMIT 10"
lnote describe --path data.parquet
lnote search-notes --query "予算についてどこに書いたか"
lnote audit-links
lnote xlsx-read --path sheet.xlsx --sheet 0
lnote data-diff --a before.parquet --b after.parquet --mode changed --keys id
lnote db-describe --connection data.lnc --table customers
lnote db-export --connection dados.lnc --sql "SELECT * FROM clientes" --out clientes.parquet
lnote due-tasks
lnote export --sql "SELECT * FROM read_csv_auto('e.csv') WHERE state='NY'" --out ny.parquet
lnote zip-list --path export.isx
lnote zip-read --path export.isx --entry job/definition.xml
lnote task-projects
lnote tasks --project Backlog
lnote create-task --project Backlog --title "Review the text" --effort 2
lnote move-task --project Backlog --task-id 5 --status-id 2
lnote git-status
lnote http --url https://api.example.com --method GET
lnote notify --message "Processing finished"

グローバルオプション: --root <folder>、--json （構造化された {ok,data,error} 出力）、--help（または lnote <command> --help）、--version。不明なコマンドには 候補が示されます（「did you mean…?」）。

古いデータの一括更新: lnote upgrade <フォルダー> は、 以前のバージョンの LightNote が書き出したファイルをまとめて新しい形式にします。現時点では、 .lns と .lne に変わった旧拡張子 .lnsh と .lnsm が対象です。各ファイルを開くときにアプリが自動で行うため、 このコマンドは対象が何十件もあって 1 つずつ開きたくない場合のためのものです。 --dry-run を付けると、何も変更せずに変更内容だけを確認できます。 必須ではなく利便性のための機能で、古いファイルはこれを使わなくても問題なく開けます。

設定とテーマ

設定のありか

ツール → 全般設定では、セクションごとに調整します: 全般オプション （言語、自動保存、アイドルタブの解放、タブのカラーパレット、ウィンドウのタイトル、 デイリーノート、スペルチェック）、アプリケーションのテーマ、エディターの フォントと色、Markdown のスタイル、 実行（インタープリター）、ターミナル（シェル）、AI アシスタント （CLI と既定の AI）、バージョン管理、データベース（ページング、 Oracle Instant Client）。

セクション一覧の上部にある検索欄で、各ページのオプションを絞り込めます。 機能セクションには、オプション機能のスイッチ（接続グラフ、付箋メモ、AI セッション、 AI チャット、音声録音、古いノートの再発見、コンピューターのスリープ抑止、Windows エクスプローラーのメニュー統合）がまとまっています。機能をオフにすると、インターフェース・ トレイ・ショートカットから消え、リソースの消費も止まりますが、作成済みのデータは 保持されます。変更は再起動時に有効になります。

テーマ

アプリケーションのテーマはプログラムの外観（メニュー、タブ、パネル、 ステータスバー）を変更します。すぐに使えるテーマが複数あります — ライト系（ライト、 Solarized Light、Catppuccin Latte、Gruvbox Light、One Light、Rosé Pine Dawn、 Everforest Light、Tokyo Night Day）と ダーク系（ダーク、Tokyo Night、Dracula、Ayu Mirage、Nord、Gruvbox Dark、 Everforest Dark、Kanagawa Wave）— に加えて、 アクセントカラー付きのカスタムモードもあります。新しいテーマはオンライン カタログから届くので、アプリを更新する必要はありません。

コードエディターと Markdown の色はそれぞれ専用のセクションで別々に選択し、 アプリケーションのテーマとは独立しています。それぞれに、すぐ使える配色（Padrão、Dracula、 One、Nord、Gruvbox、Tokyo Night のライト版・ダーク版）を選ぶテーマ: コンボ、 ライブプレビュー、そして自分の色を再利用できるプリセットとして保存する 名前を付けて保存… ボタンがあります。

ウィンドウごとのテーマ。 フォルダー（ワークスペース）ごとに独自のテーマを 設定できるので、異なる外観の 2 つのウィンドウを同時に開いておけます。ワークスペースの 設定 → このフォルダーの外観には、このウィンドウのテーマ（プログラムの外観）、 コードのテーマ、Markdown のテーマのコンボがあり、いずれも上書きしない 全般テーマに従う／既定のままを選べます。コードと Markdown のテーマを 上書きすると、全般設定を変えずにそのフォルダーだけエディターの色をダークテーマに 合わせられて便利です。これらの選択はお使いのマシンだけに保存されます（Git には 入りません）。

ツール・タイトル・レイアウト

インストールガイド。カタログのツール（AI アシスタント、インタープリター、 フォーマッター、リンター、データベースドライバー）でまだコンピューターに入っていないものを 選んだとき、またはインタープリターが見つからないファイルを実行・整形・チェックしようとしたとき、 LightNote はインストールガイドを開きます。安全なコマンド（winget 経由）が ある場合、ガイドは正確なコマンドを表示し、組み込みコンソールでワンクリックで実行します。 そのツールが別のもの（例: Node.js が必要な CLI）に依存する場合は、先に前提条件のインストールを 提案します。自動インストーラーがない場合は、公式のダウンロードページを開き、手順を案内します。 完了すると、インストールを確認し、プログラムを再起動せずにツールを使える状態にします。

整形とリンターには専用のセクションがあります（言語ごとの外部フォーマッター/ リンター、カタログから追加）。設定を別のマシンに持ち運ぶには、設定の移行 グループ（一般セクション）に設定のエクスポート/インポートがあります （.lnconf ファイル）: 一般設定とコンテンツテーマは含まれますが、API キーや ローカルパスは含まれません（移行先で再入力してください）。

ウィンドウのタイトルは自由形式のテンプレートです: アプリ名は常に末尾に付き、残りを 変数 {workspace}（ワークスペースのルートフォルダー）、{file} （開いているファイル名）、{path}（完全パス）で組み立てます。空の変数を囲む装飾 （例: [ {workspace} ] の角かっこ）は自動的に消えます。既定の [ {workspace} ] {file} — にするには欄を空欄のままにしてください。

ウィンドウレイアウト。表示 → ウィンドウレイアウト（または全般設定 → 全般 → ウィンドウレイアウト）で、3 つのプリセット—モダン（既定）、クラシック、ゆったり—から選ぶか、各項目を個別に設定できます。上部にメニューバーを表示する（有効にすると ☰ ボタンは消えます。どちらも同じメニューを開くためです）、アイコンの横にラベルを表示する、ツールバーとサイドバーを左右どちらに置くか、アイコンサイズです。プリセットは項目を埋めるだけで、あとから個別に変えても何も取り消されず、一覧の表示が「(カスタム)」に変わるだけです。変更は開いているすべてのウィンドウにすぐ反映されます。

ポータブルモード: データをプログラムの隣に

.zip 版の LightNote は、設定・セッション・ローカル履歴・インデックスをプログラムのフォルダーの外、Windows のフォルダー (%LOCALAPPDATA%) に保存します。ポータブルモードはそれらを実行ファイルの隣に移し、フォルダーごと USB メモリや外付けディスク、同期フォルダーに置けるようにします。

オンにするには: コピーを置きたい場所に .zip を展開し、設定 → 全般 → ポータブルモードを開いてこのコピーをポータブルにする…をクリックします。ウィンドウには移動元と移動先、容量、変わる点が表示されます。確定すると LightNote はコピーし (移動はしません)、プログラムを閉じて開き直すよう促します。元のコピーはそのままの場所に残るので、うまくいかなくても失われるものはありません。

その後、プログラムのフォルダーに2 つのフォルダーが増えます。profile はあなたのもの (設定・セッション・履歴・ダウンロードした辞書)、profile-cache はプログラムが自動で作り直すインデックスだけです。profile-cache はいつ削除しても構いません。

新しいバージョンに更新するには: 新しい .zip をダウンロードして新しいフォルダーに展開し、古いバージョンの profile フォルダーをその中にコピーします。それだけです。profile-cache はコピー不要です (自動で作り直されます)。コピーしても問題はなく、単に不要というだけです。逆向きは行わないでください。新しいバージョンが書いたプロファイルを読むと、プログラムはまだ読めない内容を壊さないよう読み取り専用で起動します。

オフにするには: 設定 → 全般 → ポータブルモードに戻り、ポータブルモードをオフにする…をクリックします。何も削除されません。2 つのフォルダーの名前が変わるだけで (profile.desativado と profile-cache.desativado)、次回の起動から LightNote は再び Windows のフォルダーを使います。削除するか、元に戻すか、中身をコピーするかは後で決められます。

パソコンを変えたときにフォルダーと一緒に移らないもの。次の 3 つは Windows がユーザーとマシンごとに保護しているため、別の PC では復号できません: AI のキー、記憶させたファイルのパスワード、保存されたセキュアフレーズです。向こうで入力し直すだけでよく、失われるものはありません。セキュアなファイルは、入力したセキュアフレーズで今までどおり開けます。このほか、開いているタブとフォルダーは完全なパスを保存するため、ドライブ文字が変わると場所がずれます。エクスプローラーとの統合はモードを有効にするときにオフになり (マシンの Windows に書き込むもので、ポータブルモードが避けたいことだからです)、設定で再びオンにできます。リポジトリに書かれた .mcp.json は lnote.exe の完全なパスを指すため、新しいマシンで作り直す必要があります。

AI のキーを持ち歩く（任意）。 設定 → 一般 → ポータブルモード に キーをフレーズで保護する… があります。有効にすると、AI のキーと記憶させたファイルのパスワードが Windows に依存しなくなり、フォルダーと一緒に移動します。よく考えてください。いまは USB メモリーを失っても痛手はありません（あなたのマシンの外では開けないからです）。フレーズを使うと、フォルダーを手に入れた人がじっくり推測できるようになります。長いフレーズを使ってください。ワークスペースのセキュアフレーズは、意図的にこのキーリングに入りません。それは安全なノートを開く鍵であり、1 つのフレーズですべてが開くべきではないからです。自分のパソコンで尋ねられたくなければ このマシンで記憶する にチェックを入れてください。ほかのパソコンでは、また尋ねられます。

chaveiro-do-perfil

ポータブルモードは .zip 版のためのものです。インストーラーでインストールしたコピーと Microsoft Store 版は変換できません (フォルダーが読み取り専用か、アンインストーラーの管理下にあるためです)。ボタンを無反応にする代わりに、ウィンドウがその理由を表示します。コマンドラインからは、LightNote を閉じた状態で: lnote portable --status、lnote portable --on (--dry-run も可)、lnote portable --off。

キーボードショートカット

  • F1 — このヘルプ（現在の画面のセクション）
  • Ctrl+N / Ctrl+O — 新しいファイル / ファイルを開く
  • Ctrl+S / Ctrl+W — 保存 / タブを閉じる
  • Ctrl+Alt+Shift+S — すべて保存（変更されたすべてのタブ）
  • Ctrl+F / Ctrl+H — ファイル内で検索 / 置換
  • Ctrl+Shift+F — グローバル検索（ripgrep）
  • Ctrl+Shift+G — バージョン管理パネル（Git）
  • Ctrl+Shift+E / Ctrl+Shift+M — エクスプローラーパネル / 未対応項目パネル
  • Ctrl+B — サイドバーの表示/非表示
  • Ctrl+' — ターミナル（US レイアウトでは Ctrl+` も）
  • Ctrl+/ — コメントの切り替え。Ctrl+Shift+D — 行を複製
  • F5 — ファイルを実行。Ctrl+Shift+Enter — 選択範囲をターミナルに送る
  • Ctrl+K / Ctrl+I — AI に質問 / AI で編集
  • Ctrl+B / Ctrl+I / Ctrl+E — Markdown ノートで: 太字 / 斜体 / 表示モードを切り替え
  • Ctrl+Shift+X / Ctrl+Shift+C / Ctrl+Shift+H — ノートで: 取り消し線 / 行内コード / ハイライト
  • Ctrl+1…Ctrl+6 — ノートで: 見出しのレベル（同じレベルをもう一度押すと段落に戻る）
  • Ctrl+Shift+V — ノートで: 書式なしで貼り付け
  • Ctrl+Enter — 「ここで実行」: SQL 文、ブロックのセル、API リクエスト、ノート内の図/数式のソース
  • Ctrl+Shift+R / F4 — マクロ: 記録 / 再生
  • Ctrl+R — ファイルへ移動。Ctrl+Shift+P — コマンドパレット
  • Ctrl+Shift+K — タスクへ移動。Ctrl+Shift+T — 閉じたタブを開き直す
  • Ctrl+Alt+G — コネクショングラフ
  • Ctrl+Alt+N — クイックキャプチャ（グローバル。LightNote の外でも有効）
  • Ctrl+Alt+D / Ctrl+Alt+T — 今日のノート / クイックタスク
  • Ctrl+Alt+R — 音声を録音/停止（グローバル、クイック音声メモ）
  • F11 — 禅モード（タブがウィンドウ全体を占める）
  • Ctrl++ / Ctrl+- / Ctrl+0 — ズーム

同じキーでも、フォーカスのある画面によって役割が変わります。フォーカスされたビューが優先され、その外ではウィンドウのショートカットが効きます。データベースタブにフォーカスがあるとき、F4 はマクロの再生ではなくオブジェクトのプロパティを開き、Diff と出力パネルでは F8／Shift+F8 が変更点を順にたどり、単独ファイルのウィンドウでは Alt+←／Alt+→ でフォルダーを行き来します。 絞り込み可能な完全な一覧は ヘルプ → キーボードショートカットにあります。

ライセンス・エディション・コミュニティ

LightNote は同じ機能を持つエディションで提供され、違いはライセンスと配布方法だけです:

  • LightNote（無料、ウェブサイトから）: 個人・非商用の利用向け。
  • LightNote Core（Microsoft Store）: プロジェクトへの貢献として入手し、 商用利用ライセンスを付与され、Store 経由で自動更新を受け取ります。
  • LightNote Business（将来）: ボリューム/エンタープライズ向けライセンス。将来の 提供のために予約されています。

お使いのコピーのエディション（つまりどの条項が適用されるか）は ヘルプ → バージョン情報 に表示されます。完全な条項は ヘルプ → バージョン情報 → ライセンス条項…にあります。

参加して貢献しましょう:

  • 提案や質問: GitHub Discussions — github.com/nglczr/LightNote-Community/discussions
  • バグを見つけましたか？ GitHub Issues で報告してください — github.com/nglczr/LightNote-Community/issues
  • 開発を Ko-fi で支援 — ko-fi.com/lightnote （または Store で LightNote Core を入手）
  • お問い合わせ: contato@lightnote.com.br · ウェブサイト: lightnote.com.br