Novels Note JP is an editor extension plugin specialized for writing Japanese novels. It offers not only essential features like paragraph indentation and ruby support, but also tools to assist with writing—such as terminology registration, input, and highlighting—as well as vertical-text previews, writing statistics, and manuscript export driven by fully customizable manuscript cleaning rules. It supports both desktop and mobile platforms.
Any .md file with mode: novel in its frontmatter is treated as Novel Mode (a manuscript), and the plugin's editor features are applied to it. Regular notes are unaffected.
---
mode: novel
---
Note Novel Mode detection is based on YAML frontmatter, but Obsidian only parses frontmatter for
.mdfiles. Frontmatter is not recognized in.txtfiles, so addingmode: novelthere will not enable Novel Mode (fonts, term highlighting, bracket highlighting, ruby rendering, word count, etc. will not work). The ".txt file support" described below only covers opening/editing files and the vertical-text preview.

.txt file support — Open and edit plain text files directly, with vertical-text preview also available. Note that Novel Mode itself is not included for .txt files (see the note under Novel Mode above for details).Select text in the editor and right-click to see items in the context menu.
Ruby notation is also rendered inline in the editor as an HTML <ruby> element, so it stays readable while you write.
On mobile: Since there is no way to open a right-click menu on mobile, the same functionality is provided as commands instead. Select some text, then run Add ruby to selected text / Add emphasis dots to selected text from the command palette (or from a command you've added to the mobile toolbar).
Four ruby notations are supported (switchable uniformly in settings):
| Style | Notation |
|---|---|
| Narou-style | |Kanji《Ruby》 (half-width vertical bar) |
| Aozora Bunko-style | |Kanji《Ruby》 (full-width vertical bar) |
| Denden-style | {Kanji|Ruby} |
| HTML | <ruby>Kanji<rt>Ruby</rt></ruby> |
The filename (or the value of the name property, if set) of any note tagged with a category tag (character, location, glossary, organization, item) is registered as a term and highlighted in the editor. You can configure a color and an on/off toggle for each category. You can also register alternate names via aliases.
---
tags: character
aliases: (register alternate names)
---
Hovering over a highlighted term in the editor shows the corresponding term note via Obsidian's standard Page Preview (Hover Preview).
On mobile: Since hovering doesn't exist on mobile, this feature is disabled there. Instead, select the text and run the Open term note for selected text command to view the term note's content (a body preview) in a modal. You can also open the note directly from "Open term page" in the modal.
While writing, typing a trigger character (/ by default) opens the glossary input palette near your cursor, letting you search and insert terms registered in the term index right there — no need to go find the term note yourself.

name / aliases) to find the notation you want.name set) skip the notation-selection screen entirely and can be selected directly./ character for other reasons.On mobile: The glossary input palette may overlap with the on-screen keyboard. Tap anywhere in the palette's empty space (outside the search field) to dismiss the keyboard.
Highlights Japanese brackets (「」『』()【】〈〉《》) by type, with a configurable color and individual on/off toggle for each.
Displays a list of terms as a folder tree in the right sidebar.
You can specify a folder path when creating a new term note. If the specified folder doesn't exist, a confirmation dialog appears before it's created.
On mobile: Long-press a category or folder to open the "create new" menu (in place of right-click). Drag-and-drop of terms works for moving between folders, but inserting into the main pane (as a WikiLink into the manuscript) doesn't work due to drag-and-drop limitations on mobile. Instead, tap a term to open a menu where you can choose "Open note," "Insert into manuscript," or "Copy link to clipboard." "Insert into manuscript" inserts at the cursor position of the manuscript note you were most recently editing (if no manuscript is open, it's copied to the clipboard automatically instead).
A rule set that defines how Markdown notation and Obsidian-specific elements (frontmatter, callouts, WikiLinks, etc.) should be handled — kept, removed, or converted — during export and word counting. Create and edit these rules in a dedicated editor from the settings screen, and switch between multiple rule sets depending on the task.
manuscript-rules.json), and switch between multiple files. Rule files are stored in the plugin's own folder rather than the vault, so they won't appear in your note list.| Metadata / Block-level elements | Inline elements / Document-wide formatting |
|---|---|
![]() |
![]() |
Displays three counting modes in the status bar (desktop only; this display is unavailable on mobile due to Obsidian's own limitations, which don't provide a status bar there).
Whether to include full-width spaces, blank lines, and hashtags in the count is also configurable.
Previews the note currently shown in the main pane in a vertical-text layout.

On mobile: On desktop, this opens in the right sidebar so you can write while checking it alongside the editor, but on mobile, due to screen size constraints, it can't be shown at the same time as the editor, so it opens as an independent tab instead. As a result, cursor position sync and cursor-line highlighting don't work on mobile. Note that the line-wrap width setting may also not fit exactly as specified, depending on your screen height.
A clean reading view with WikiLinks, tags, and non-body content stripped out. Shows a popup notice for files that aren't in Novel Mode. An export button sits next to the edit button.

Exports the current note as clean manuscript text from a dedicated export dialog, based on your manuscript cleaning rules.
.txt / .md)
Aggregates all mode: novel notes across your vault and lists them in the main pane.

The same steps work in the mobile app.
main.js, manifest.json, and styles.css from the latest release<vault>/.obsidian/plugins/novels-note-jp/mode: novel to the frontmatter of any note you want to use as a manuscript.Desktop:
Mobile:
Create notes for characters, locations, terminology, etc., and assign the corresponding category tag:
| Tag | Category |
|---|---|
character |
Character names |
location |
Place names |
glossary |
Terminology / worldbuilding |
organization |
Organizations / groups |
item |
Items / objects |
The note's filename (or the value of its name property, if set) is registered as a term and automatically highlighted in Novel Mode editors. Five categories are provided by default, but you're free to add or remove categories as you like.
While writing, typing the trigger character (/ by default) opens the glossary input palette near your cursor. Type a term name or alias into the search field, or browse via "Recent," "Category," or "All" to find the term you want, then insert it into the manuscript with Enter or the "Insert" button. You can cancel at any time with Escape, or (on mobile) the modal's close button.
If you'd rather invoke it without typing the trigger character, run Open glossary input palette from the command palette, or assign a hotkey to it. On mobile, you can also register this action as a mobile toolbar button.
The scope in which the palette can be triggered, the trigger character, and clearing the "Recent" history can all be changed under Settings → Novels Note JP → "Glossary input palette."
Run Novels Note JP: Open vertical preview from the command palette (Ctrl/Cmd + P). It opens in the right sidebar on desktop, or as a new tab on mobile.
Run Novels Note JP: Open novel reading view from the command palette to switch the current note to the novel reading view.
Go to Settings → Novels Note JP → "Manuscript Cleaning Rules" → "Add rules file" to create one. In the editor that opens, choose "keep / remove / convert" for each element, then click "Save." Once you select it as the "default rules file," it's applied automatically to future exports and word counts.
Run Novels Note JP: Export current file as manuscript from the command palette.
Run Novels Note JP: Open writing stats from the command palette to open the manuscript aggregation view as a new tab.
| Setting | Description |
|---|---|
| Font size | Font size used in Novel Mode editors |
| Line height | Line height used in Novel Mode editors |
| Line-wrap width | Number of full-width characters per line |
| Show wrap guideline | Show/hide the line-wrap ruler (color, opacity, solid/dashed) |
| Ruby notation | The notation used for ruby input, inline rendering, and export (Narou-style / Aozora Bunko-style / Denden-style / HTML) |
| Vertical preview cursor highlight | Cursor line background color and on/off (not adjustable on mobile) |
| Full-width space & line-break marker visibility | Show/hide toggle, plus style (dot / underline / border) and color |
| Word count mode | Raw character count / Novel-weighted count / Manuscript-paper equivalent (desktop only) |
| Word count options | Whether to include full-width spaces, blank lines, and hashtags in the count |
| Term index excluded folders | Folders excluded from the term index |
| Writing stats excluded folders | Folders excluded from writing-stats aggregation (managed separately from the term index's excluded folders) |
| Default manuscript cleaning rules | The default rules file used for export and word counting (falls back to the built-in default if none is set) |
| Reading speed (chars/min) | Reading speed used to estimate reading time in writing stats (default: 400 chars/min) |
| Term highlighting: master toggle | Turns all highlighting features on/off at once |
| Term category colors & toggles | Color and on/off for each term category |
| Bracket colors & toggles | Color and on/off for each bracket type |
| Glossary palette: enable | Turns the entire glossary input palette feature on/off |
| Glossary palette: scope | Where the palette can be triggered (Manuscript notes only / Manuscript + glossary notes / All notes) |
| Glossary palette: trigger character | The character that opens the palette (default: /) |
| Glossary palette: clear history | Deletes the entire "Recent" history (with a confirmation dialog) |
As of version 0.9.0, this plugin supports the mobile versions of Obsidian.Core writing, highlighting, ruby, export, and term-management features work the same as on desktop, but due to mobile-specific constraints, some features work differently or aren't available. See the "On mobile:" notes within each feature section above for details.
Novels Note JPは日本語小説の執筆に特化したエディタ拡張系プラグインです。執筆に欠かせない先頭字下げやルビ機能だけでなく、執筆を補助するための用語の登録・入力・ハイライト機能、原稿を確認するための縦書きプレビューや執筆情報の表示機能、細かくルールをカスタマイズできる原稿クリーニング機能に基づくエクスポート機能も提供しています。デスクトップ・モバイルの両方に対応しています。
フロントマターに mode: novel を記載した.mdファイルがノベルモード(原稿)として扱われ、プラグインのエディタ機能が適用されます。通常のノートには影響を与えません。
---
mode: novel
---
注意 ノベルモードの判定は YAML フロントマターに基づいていますが、Obsidian はフロントマターを
.mdファイルに対してのみ解析します。.txtファイルではフロントマターが認識されないため、mode: novelを記載してもノベルモードは有効になりません(フォント・用語ハイライト・括弧ハイライト・ルビ表示・文字数カウントなどの機能は動作しません)。後述する「.txtファイル対応」は、あくまでもファイルの開閉・編集と縦書きプレビューのみを対象としています。

.txt ファイル対応 — プレーンテキストファイルを直接開いて編集でき、縦書きプレビューも利用可能です。ただし、ノベルモード自体は含まれません(詳細は上記ノベルモードの注意書きを参照)エディタ上で文字列を選択して右クリックすると、コンテキストメニューに項目が表示されます。
ルビ記法はエディタ上でも HTML の <ruby> 要素としてインラインレンダリングされるため、執筆中も読みやすい表示で確認できます。
モバイルでは: モバイル環境には右クリックメニューを開く手段がないため、同じ機能をコマンドとして提供しています。文字列を選択したうえで、コマンドパレット(または
モバイルツールバーに登録したコマンド)から選択した文字列にルビを振る/選択した文字列に傍点を振るを実行してください。
対応しているルビ記法は以下の4種類です(設定で統一的に切り替え可能):
| 方式 | 記法 |
|---|---|
| なろう式 | |漢字《ルビ》(半角縦棒) |
| 青空文庫式 | |漢字《ルビ》(全角縦棒) |
| でんでん式 | {漢字|ルビ} |
| HTML | <ruby>漢字<rt>ルビ</rt></ruby> |
カテゴリタグ(character、location、glossary、organization、item)が付いたノートのファイル名(または name プロパティの値)が用語として登録され、エディタ上でハイライト表示します。カテゴリごとに色と表示のオン/オフを設定できます。また、aliases にて別名を登録することもできます。
---
tags: character
aliases: (別名を登録)
---
エディタ上でハイライトされた用語にマウスを合わせると、対応する用語ノートを Obsidian 標準のページプレビュー(Hover Preview)で確認できます。
モバイルでは: ホバー(マウスを合わせる操作)自体が存在しないため、この機能はモバイルでは無効になります。代わりに、文字列を選択して 選択した文字列の用語ノートを開く コマンドを実行すると、用語ノートの内容(本文プレビュー)をモーダル表示で確認できます。モーダルの「用語ページを開く」からノートを直接開くことが可能です。
執筆中にトリガー文字(デフォルトは /)を入力すると、カーソル位置の近くに用語入力パレットが表示され、用語インデックスに登録されている用語をその場で検索・入力できます。用語インデックスを開かなくても入力できます。

無効になっています。使用する場合は「用語入力パレットを有効にする」をオンにしてください。name / aliases)という階層をたどって目的の表記を選べますname を設定していない等)は、表記選択の画面を経由せず直接選べます/」 を書く機会が多いノートで誤って起動してしまうのを防げますモバイルでは: 用語入力パレットとソフトウェアキーボードが重なって表示される場合があります。用語入力パレットの余白部分(検索欄以外)をタップすることでソフトウェアキーボードを閉じることができます。
日本語括弧(「」『』()【】〈〉《》)を種類ごとに色設定・個別トグルでハイライト表示します。
右サイドバーに用語の一覧をフォルダツリー形式で表示します。
用語ノートの新規作成時にフォルダパスを指定できます。指定したフォルダが存在しない場合、作成前に確認ダイアログが表示されます。
モバイルでは: カテゴリ・フォルダの長押しで新規作成メニューが開きます(右クリックの代わり)。用語のドラッグ&ドロップは、フォルダ間の移動には対応していますが、メインペインへの挿入(原稿へのWikiLink挿入)はモバイル環境のドラッグ&ドロップの制約により動作しません。代わりに、用語をタップするとメニューが開き、「ノートを開く」「原稿に挿入」「リンクをクリップボードへコピー」を選択できます。「原稿に挿入」は、直前まで編集していた原稿ノートのカーソル位置に挿入されます(原稿を開いていない場合は自動的にクリップボードへコピーされます)。
Markdown記法やObsidian特有の要素(Frontmatter、Callout、WikiLinkなど)を、エクスポートや文字数カウントの際にどう扱うか(保持する/削除する/変換する)をまとめたルールセットです。設定画面から専用のエディタで作成・編集し、複数のルールセットを用途に応じて使い分けられます。
manuscript-rules.json)を新規作成・複製・リネーム・削除でき、複数ファイルを切り替えて使えます。定義ファイルはVaultではなくプラグイン専用フォルダに保存されるため、Vault内のノート一覧には表示されません。| メタデータ / ブロック要素 | インライン要素 / 文章全体の整形 |
|---|---|
![]() |
![]() |
3つのカウントモードをステータスバーに表示します(デスクトップ版のみ。モバイルでは Obsidian 側の仕様によりステータスバーが利用できないため、この表示はありません)。
全角スペース・空行・ハッシュタグをカウントに含めるかどうかもオプションで設定できます。
メインペインに表示されているノートを縦書きレイアウトでプレビューします。

モバイルでは: デスクトップでは右サイドバーに開き、エディタと並べて確認しながら執筆できますが、モバイルでは画面の制約上エディタと同時に表示できないため、独立したタブとして開きます。これに伴い、カーソル位置同期・カーソル行ハイライトはモバイルでは動作しません。折り返し桁数の設定も、画面の高さによっては指定した文字数どおりに収まらない場合があるので注意してください。
WikiLink・タグ・本文以外のコンテンツを除去したクリーンな閲覧ビューです。ノベルモードでないファイルにはポップアップで通知します。編集ボタンの隣にエクスポートボタンも配置されています。

専用のエクスポートダイアログから、現在のノートを「原稿クリーニング定義」に基づいてクリーンな原稿テキストとして出力します。
.txt / .md)を選択可能
Vault 全体の mode: novel ノートを集計し、メインペインに一覧表示します。

モバイル版アプリでも同じ手順でインストールできます。
main.js、manifest.json、styles.css をダウンロード<vault>/.obsidian/plugins/novels-note-jp/mode: novel を記入する。デスクトップ:
モバイル:
登場人物・場所・用語などのノートを作成し、対応するカテゴリタグを付与します:
| タグ | カテゴリ |
|---|---|
character |
人物名 |
location |
場所名 |
glossary |
用語・世界観設定 |
organization |
組織・団体 |
item |
アイテム・道具 |
ノートのファイル名(または name プロパティを設定している場合はその値)が用語として登録され、ノベルモードのエディタで自動的にハイライトされます。 また、デフォルトで5つのカテゴリを用意してありますが、自由に追加・削除ができます。
執筆中にトリガー文字(デフォルト /)を入力すると、カーソル付近に用語入力パレットが開きます。検索欄に用語名や別名を入力するか、「最近使った」「カテゴリ」「すべて」から目的の用語をたどり、Enter または「入力」ボタンで本文に挿入します。Escape、または(モバイルでは)モーダルの閉じるボタンでいつでも中断できます。
トリガー文字を打たずに呼び出したい場合は、コマンドパレットから 用語入力パレットを起動 を実行するか、任意のホットキーを割り当てて使用してください。モバイルでは、この操作をモバイルツールバーのボタンとして登録することができます。
起動できる範囲、トリガー文字、「最近使った」履歴のクリアは、設定 → Novels Note JP → 「用語入力パレット」から変更できます。
コマンドパレット(Ctrl/Cmd + P)から Novels Note JP: 縦書きプレビューを開く を実行します。デスクトップでは右サイドバー、モバイルでは新規タブとして開きます。
コマンドパレットから Novels Note JP: 小説閲覧ビューを開く を実行すると、現在のノートを小説閲覧ビューに切り替えます。
設定 → Novels Note JP → 「原稿クリーニング定義」→「定義ファイルを追加」から新規作成します。開いたエディタで各要素の「保持/削除/変換」を選び、「保存」をクリックしてください。「既定として使う定義ファイル」に選択すると、以後のエクスポート・文字数カウントに自動的に適用されます。
コマンドパレットから Novels Note JP: 現在のファイルを原稿 Export する を実行します。
コマンドパレットから Novels Note JP: 執筆情報一覧を開く を実行すると、原稿の集計一覧が新規タブとして開きます。
| 設定項目 | 説明 |
|---|---|
| フォントサイズ | ノベルモードのエディタで使用するフォントサイズ |
| 行間 | ノベルモードのエディタで使用する行間 |
| 折り返し桁数 | 1行あたりの全角文字数 |
| 折り返しガイドラインの表示 | 折り返し位置の定規の表示/非表示(色・不透明度・実線/破線) |
| ルビ設定 | ルビ入力・インラインレンダリング・エクスポートに使用する記法(なろう式 / 青空文庫式 / でんでん式 / HTML) |
| 縦書きプレビューのカーソルハイライト | カーソル行の背景色とオン/オフ(モバイルでは操作不可) |
| 全角スペースと改行記号の可視化 | 表示/非表示の切り替えと、スタイル(ドット・下線・ボーダー)・色の設定 |
| 文字数カウントモード | 生文字数 / 小説用重み付き / 原稿用紙換算(デスクトップのみ表示) |
| 文字数カウントオプション | 全角スペース・空行・ハッシュタグをカウントに含めるか |
| 用語インデックス 除外フォルダ | 用語インデックスから除外するフォルダ |
| 執筆情報一覧 除外フォルダ | 執筆情報一覧の集計対象から除外するフォルダ(用語インデックスの除外フォルダとは別に管理) |
| 既定の原稿クリーニング定義 | エクスポートと文字数カウントに使う既定の定義ファイル(未設定時は組み込みの初期設定) |
| 読了速度(字/分) | 執筆情報一覧の推定読了時間の計算に使う読書速度の目安(デフォルト400字/分) |
| 用語ハイライト:全体トグル | すべてのハイライト機能の一括オン/オフ |
| 用語カテゴリカラー・トグル | 用語カテゴリごとの色とオン/オフ |
| 括弧カラー・トグル | 括弧の種類ごとの色とオン/オフ |
| 用語入力パレット:有効化 | 用語入力パレット機能全体のオン/オフ |
| 用語入力パレット:起動範囲 | パレットを起動できる範囲(原稿ノートのみ / 原稿ノート+用語ノート / すべてのノート) |
| 用語入力パレット:トリガー文字 | パレットを開くトリガー文字(デフォルト /) |
| 用語入力パレット:履歴クリア | 「最近使った」の履歴をすべて削除(確認ダイアログあり) |
バージョン 0.9.0 より、モバイル版 Obsidian に対応しました。基本的な執筆・ハイライト・ルビ・エクスポート・用語管理機能はデスクトップと同様に利用できますが、モバイル特有の制約により、一部の機能は操作方法が異なる、または利用できません。詳細は各機能セクション内の「モバイルでは:」の記載を参照してください。