User Guide

InkNel の
使い方ガイド

Markdown ノートの作成から、画像・添付ファイル、AI 連携、プラグイン、バックアップまで。アプリから作成した情報をもとに、主要な操作をまとめました。

基本操作 Markdown 画像と添付保存と同期 AI 機能プラグインショートカット

Overview

InkNel でできること

InkNel は、Markdown でメモを書くためのデスクトップアプリです。ノートは .md ファイルとして保存され、画像・添付ファイル・タグ・検索・AI 連携・プラグイン拡張を組み合わせて使えます。

Markdown ノート

CodeMirror ベースの編集ビューと HTML プレビューを切り替えながら、見出し、リスト、表、コードブロックを扱えます。

ローカル中心のデータ管理

保存先には notes/、images/、attachments/、plugins/ が作られ、Markdown ファイルとして扱えます。

AI とプラグイン

AI チャット、AI 変換、ノート編集モードに加えて、Mermaid、Mindmap、Math、Schedule などの拡張を追加できます。

Basics

基本操作

最初に押さえておきたい操作です。ノートの作成、整理、検索、日付ノートまで、日常的に使う流れをまとめています。

ノートを作成する

左端のアクティビティバーで「ファイル」を開き、サイドバー上部の新規ノートボタンを押します。タイトルと本文を入力すると、本文は自動保存されます。

ノート 1 件につき 1 つの Markdown ファイルとして保存されます。
画像用の images/、添付ファイル用の attachments/ も保存先に作成されます。

フォルダとタグで整理する

サイドバーの新規フォルダボタンでフォルダを作成できます。ノートやフォルダは名称変更でき、ノートをフォルダへドラッグすると移動できます。

フォルダは実ディレクトリではなく、ノートのメタ情報として管理される仮想フォルダです。
タグは本文中の #word ではなく、TagBar で明示的に設定したものが対象です。

編集ビューとプレビューを切り替える

ノート上部の切替ボタンで、Markdown を編集するビューと、HTML として表示するプレビュービューを切り替えます。

編集ツールバーから、見出し、太字、斜体、コード、リスト、引用、リンク、表、日付、テンプレートなどを挿入できます。
タスクリストはプレビュー上のチェックボックスをクリックして状態を切り替えられます。

タブと検索を使う

複数のノートをタブで開けます。設定で「ノートクリック時に常に新しいタブで開く」挙動も選べます。

検索パネルではタイトルと本文を検索でき、一致部分がハイライトされます。
検索欄では ↑ / ↓ で過去の検索キーワードを呼び出せます。

履歴とカレンダーを使う

履歴機能を有効にすると、開いたノートの履歴をサイドバーに表示できます。カレンダー機能を有効にすると、日付をクリックしてその日のノートを作成できます。

既に日付ノートがある日は、そのノートを開きます。
日付ノートの保存フォルダとタイトル書式は設定で変更できます。

Markdown

Markdown でできること

基本的な Markdown 記法に加えて、コードブロックのシンタックスハイライト、コピーボタン、行番号表示などを設定できます。

用途	記法例	補足
見出し	`# 見出し`	階層に応じて `##`、`###` を使います。
強調	`太字` / `斜体`	打ち消しは `~~削除~~` です。
リスト	`- 項目` / `1. 項目`	タスクリストは `- [ ]` / `- [x]` です。
引用	`> 引用`	メモの引用や抜粋に使えます。
リンク	`[表示名](https://example.com)`	添付ファイルへのリンクにも使います。
画像	`![代替テキスト](images/xxx.png)`	画像はプレビューでクリック拡大できます。
テーブル	`\| 列1 \| 列2 \|`	編集ツールバーから雛形を挿入できます。
コードブロック	```js	JavaScript、TypeScript、Python、Go、Rust、Bash、SQL、YAML、JSON、HTML、CSS などに対応します。

Files

画像と添付ファイル

画像や資料はエディタへドラッグ＆ドロップするだけで保存され、Markdown のリンクとして挿入されます。

画像を挿入する

画像ファイルをエディタへドラッグ＆ドロップすると、画像が保存され、Markdown に画像リンクが挿入されます。画像は SHA-256 で命名されるため、同じ画像を複数回追加しても重複保存されにくい仕組みです。

対応形式: PNG、JPG / JPEG、GIF、WebP、SVG、AVIF、BMP
プレビュー上の画像はクリックで拡大表示できます。

添付ファイルを挿入する

PDF、ZIP、LZH、LHA、7z などをエディタへドラッグ＆ドロップすると、添付リンクとして挿入されます。プレビューでクリックすると OS の既定アプリで開きます。

PDF は 1 ページ目のサムネイルを生成できると、画像付きリンクとして挿入されます。
添付ファイルは attachments/ に保存されます。

Protection

ノートの保護とテンプレート

重要なノートは保護・シークレット設定を使い、繰り返し使う書式はテンプレートとして管理できます。

ノートを保護する

ノートには「保護」と「シークレット」を設定できます。初期パスワードは 1234 です。設定の「保護」から変更してください。

保護: 編集時に 4 桁のパスワードが必要です。保護中のノートは削除できません。
シークレット: 表示にもパスワードが必要です。

テンプレートを使う

テンプレート用フォルダに置いたノートを、現在のノートへ挿入できます。既定のテンプレートフォルダは template です。

設定でテンプレートフォルダ名を変更できます。
テンプレートに設定されたタグは、挿入先ノートのタグへマージされます。

Storage

インポート、保存先、同期、バックアップ

Markdown の取り込み・書き出し、保存先変更、ローカル同期、クラウド同期、ZIP バックアップを使ってデータを管理できます。

インポートとエクスポート

.md ファイルの取り込み、フォルダ配下の .md ファイルの再帰取り込みに対応します。現在のノートは Markdown として書き出せ、印刷または PDF 書き出しも利用できます。

ゴミ箱

削除したノートはすぐに完全削除されず、ゴミ箱へ移動します。ゴミ箱内のノートは復元でき、ゴミ箱を空にすると物理削除されます。

保存先を変更する

保存先を変更すると、notes/、images/、attachments/、plugins/ がその配下で管理されます。

ローカル同期

保存先フォルダと SQLite DB の差分をスキャンし、DB からディスクへの書き出し、ディスクから DB への取り込み、削除反映を実行できます。

クラウド同期

iCloud Drive、Dropbox、Google Drive のローカル同期フォルダを使う設計です。OAuth やクラウド API ではなく、各サービスのローカル同期フォルダへ InkNel/ データを配置して同期します。

バックアップとリストア

設定のバックアップ画面から保存先フォルダを ZIP として書き出せます。リストアでは既存の保存先データが置き換えられ、復元後に Markdown ファイルから DB を再構築します。

主なデータ:

SQLite DB: ノートメタ情報、フォルダ、タグ、設定、検索用情報など
notes/: ノート本文の Markdown ファイル
images/: ノートに挿入した画像
attachments/: PDF や ZIP などの添付ファイル
plugins/: ダウンロードしたプラグイン

AI 機能

設定の AI 画面でプロバイダ、Token、Endpoint、Model、ベースプロンプトを保存できます。AI チャットでは現在のノートを文脈として質問できます。

対応プロバイダ

一般的な AI、ChatGPT、ClaudeCode、Copilot、Gemini を選択できます。プロバイダごとに接続情報とモデルを保存できます。

AI チャット

現在のノートについて質問し、関連ノートを参照した回答を受けられます。チャット履歴、応答中断、Markdown ノートとしての保存、PDF または画像の添付にも対応します。

AI 編集モード

AI が新しいノートの作成、現在のノート末尾への追記、現在のノートの書き換え、直前の AI 編集の取り消しを提案・実行できます。

AI 変換

HTML から Markdown、ノート要約、タイトル生成、見出し別要約、箇条書き整理、テーブル整形、コードブロック改善、口調変換、クイズ作成などを実行できます。

Settings

設定で変更できる主な項目

外観、エディタ、タブ、検索、AI、カレンダー、プラグインなどを設定画面から調整できます。

テーマ: ダーク / ライト、表示言語、本文フォント、サイドバー幅

編集ツールバー、日付挿入フォーマット、ミニマップ、コードコピー、行番号

ノートクリック時に常に新しいタブで開くかどうか

検索履歴の保持、最大件数、ノート開封履歴の有効化

AI プロバイダ、Token、Endpoint、Model、会話履歴ターン数

カレンダー機能、日付ノートの保存フォルダ、タイトル書式

有効化するプラグイン、カタログ URL、開発モード

保護パスワード、保存先、バックアップ、リストア

Plugins

プラグイン

InkNel はプラグインで Markdown プレビュー、ツールバー、サイドバーを拡張できます。設定画面のプラグインパネルから取得・インポート・有効化します。

Mermaid

ID: mermaid / バージョン: 1.0.3。```mermaid コードブロックを図として描画します。シーケンス図、フローチャート、ER 図、ガントチャートなどを書けます。

Mindmap

ID: mindmap / バージョン: 1.0.0。```mindmap コードブロックをマインドマップとして描画します。ノード編集、追加、削除、ドラッグ＆ドロップ、拡大縮小に対応します。

Math (TeX)

ID: math / バージョン: 1.0.0。```math コードブロックを TeX 記法の数式として描画します。エディタツールバーから雛形を挿入できます。

Schedule

ID: schedule / バージョン: 1.0.0。```schedule コードブロックを 1 日のタイムスケジュール表として描画します。予定の追加・編集、8 時間表示、スクロール閲覧に対応します。

取得と有効化の流れ:

設定を開き、「プラグイン」を選びます。
プラグインカタログを取得し、使いたいプラグインをダウンロードします。
インストール済み欄でインポートし、トグルを ON にして有効化します。

Shortcuts

主なキーボード操作

アプリ内でよく使う macOS 向けのキーボード操作です。

新規ノートCmd + N

検索Cmd + F

置換Cmd + R

設定を開くCmd + ,

印刷 / PDF 書き出しCmd + P

AI チャット送信Enter

AI チャット改行Shift + Enter

AI チャット中断Esc

検索履歴 / AI 入力履歴↑ / ↓

InkNel を使い始める

Markdown で書き、ローカルに保存し、必要なときだけ AI とプラグインで拡張できます。

ダウンロードへ