An Obsidian plugin for writing novels in Japanese. It renders Japanese paragraph indentation correctly, displays ruby (furigana) and emphasis dots written in the Kakuyomu / Aozora Bunko / Narou notations, and counts characters the way Japanese prose is usually counted.

日本語のドキュメントは こちら にあります。

Features

• Correct display of Japanese indentation written with a leading full-width space
• Optional visualization of whitespace and line breaks in the editor
• Ruby (furigana) and emphasis dots, rendered in both Reading view and Live Preview
• Commands to insert and remove ruby and emphasis markup
• Copy the heading section under the cursor to the clipboard
• Character counting tuned for Japanese prose, in the status bar and next to headings
• Highlighting of the pane you are editing in, so split views stay easy to tell apart

Installation

1. Open Settings → Community plugins in Obsidian.
2. Select Browse and search for Japanese Novel Tool.
3. Select Install, then enable the plugin.

Usage

Indentation

Japanese paragraphs are indented with a full-width space (　) at the start of the line. Obsidian's default wrapping misaligns the lines that follow; this plugin adjusts the display so the indentation stays consistent in Reading view as well as in Live Preview and Source mode.

Ruby (furigana)

漢字《かんじ》
｜任意の本文《にんいのほんぶん》
|半角パイプも使用可能《はんかくぱいぷもしようかのう》

The 漢字《かんじ》 form can be used when the base text consists only of kanji. When the base text contains kana or symbols, mark its range explicitly with ｜ or |.

Emphasis dots

Aozora Bunko / Narou style, which is really ruby:

｜重要《﹅﹅》

Kakuyomu style, rendered with text-emphasis:

《《重要》》

Commands

In a file with no headings, both copy commands copy the whole document. If the file has headings but the cursor sits before the first one, the text from the beginning of the file up to that heading is copied.

Character count

Characters are counted rather than words. The count is shown in the status bar, and optionally next to each heading for the section it introduces. By default whitespace, line breaks, ruby and emphasis control characters, Obsidian callouts, and Markdown comments are excluded from the count.

When callout exclusion is enabled, editing a callout's title or body also leaves the per-heading count unchanged. Ordinary blockquotes are still counted.

Settings

The settings tab is grouped into five sections:

• Indentation — turn the indentation display on or off
• Visualization — show marks for full-width spaces, tabs, and line breaks
• Ruby — enable ruby and emphasis rendering, choose the Kakuyomu emphasis form, set the ruby size ratio, and pick the format and character used when inserting emphasis dots
• Active pane — outline the pane you are editing in, highlight the line the cursor is on, pick the accent color, and optionally limit all of this to split layouts
• Character count — enable the status bar and per-heading counts, set a prefix and suffix, and choose what is excluded from the count

The Japanese section below documents every option with its default value.

Privacy

This plugin makes no network requests. It reads notes only through the Obsidian API in order to count characters and render markup, and it stores nothing but its own settings. The two "Copy current section" commands write to the system clipboard when you run them; the plugin never reads the clipboard.

License

MIT

日本語

Obsidianで日本語小説を書くための補助プラグインです。

次の機能をまとめて提供します。

• 日本語の行頭全角空白による字下げを適切に表示
• 空白と改行の可視化（オプション）
• カクヨム/青空文庫/小説家になろう系のルビと傍点表示
• ルビと傍点の挿入コマンド
• 見出しセクション単位のクリップボードコピー
• 日本語小説向けの文字数カウント
• 編集中のペインの強調（分割表示でどちらを編集しているかを見分けやすくする）

インストール

1. Obsidianで「設定」→「コミュニティプラグイン」を開きます。
2. 「閲覧」を選び、Japanese Novel Tool を検索します。
3. 「インストール」を選び、プラグインを有効化します。

使い方

字下げ

行頭に全角スペースを入れた日本語の字下げを、できるだけ正しく表示します。 Live Preview / Source modeでは、Obsidian標準の折り返し字下げによるずれを抑えるCSSを適用します。

空白と改行の可視化

エディタ（Live Preview / Source mode）で、空白と改行を薄い色のマークとして表示できます。どちらも既定ではオフです。

• 全角スペース: □
• タブ: →
• 改行: 行末に ↵（禁則処理と同様にぶら下げ表示され、マークだけが次の行へ送られることはありません）

アクティブなペインの強調

エディタを分割しているとき、いま編集しているペインを見分けやすくします。

• ペインの枠線（または左端のバー）をアクセント色で表示します。Live Preview / Source mode / Reading viewのいずれでも表示され、サイドバーや検索欄にフォーカスが移っても、最後に編集していたペインを強調したままにします。
• キーボード入力を受け取っているエディタで、カーソルのある行の背景を強調できます（既定ではオフ）。

強調色は次から選べます。いずれもObsidianのテーマ変数なので、テーマとライト/ダークの切り替えに追従します。

既定では、表示中のエディタが2つ以上あるときだけ強調します。単一ペインでも常に強調したい場合は「分割しているときだけ強調」をオフにしてください。

ルビ

次の書式のルビをレンダリングして表示します。

漢字《かんじ》
｜任意の本文《にんいのほんぶん》
|半角パイプも使用可能《はんかくぱいぷもしようかのう》

漢字《かんじ》 形式は、ルビ対象が漢字のみで構成される場合に使えます。ひらがなや記号を含む語句にルビを振る場合は、｜ または | で対象範囲を明示してください。

傍点

青空文庫・小説家になろう系の傍点（実体はルビ）:

｜重要《﹅﹅》

カクヨム形式の傍点（text-emphasis）:

《《重要》》

ルビと傍点は同時には適用しません。

コマンド

Obsidianのコマンドパレットから次のコマンドを使えます。

見出しセクションのコピーは、カーソル位置に応じて対象が変わります。

• 見出しが1つもないファイルでは、どちらのコマンドでも全文をコピーします。
• 見出しはあるが、カーソルが最初の見出しより前（前文）にある場合は、先頭から最初の見出しの直前までをコピーします。

設定

設定画面は次の5グループに分かれています。

字下げ

可視化

ルビ

青空文庫・なろう形式で傍点を挿入する場合、傍点文字は対象となる文字の数だけ繰り返されます。

例:

｜重要《﹅﹅》

アクティブなペイン

文字数カウント

文字数カウントの仕様

文字数カウントは日本語小説向けに、単語数ではなく文字数を数えます。

既定では次を数えません。

• 空白
• 改行
• ルビ/傍点の制御文字
• Obsidian Callout
• Markdownコメント

見出し横のセクション文字数は、次の同じ階層または上位階層の見出しまでを対象にします。

「ObsidianのCalloutを数えない」がオンの場合、Calloutのタイトルや本文を編集しても、見出し横の文字数には加算・減算されません。通常の引用ブロックはカウント対象です。

# 第一章

## 一

本文...

## 二

本文...

この場合、## 一 は次の ## 二 まで、# 第一章 は章全体を数えます。

注意事項

• 見出し構造を大きく変更した直後は、表示更新まで少し遅れることがあります。
• コピペや置換など複雑な編集では、正確性を優先して見出しカウントを再構築します。
• ルビ入力中の行は、入力の軽さを優先して一時的に装飾を外します。カーソルを移動すると再表示されます。
• 字下げ表示はObsidianのMarkdownレンダリング結果に依存します。行頭の全角スペースだけを編集した直後は、ノートを開き直すと反映されやすい場合があります。

参考にしたプラグイン

• Jisage
• Japanese Novel Ruby
• Better Word Count

免責事項

本プラグインは現状のまま提供されます。作者は、本プラグインの使用または使用不能によって生じたいかなる損害についても責任を負いません。

本プラグインの動作について正確性や完全性を保証するものではありません。利用者の責任においてご使用ください。

本プラグインは予告なく仕様変更、更新、公開停止される場合があります。

ライセンス

MIT License

変更履歴

[0.1.10] - 2026-09-20

• 「ObsidianのCalloutを数えない」がオンでも、Callout内の編集が見出し横の文字数に加算・減算される不具合を修正
• Calloutのタイトル・本文の編集、除外設定のオン・オフ、通常の引用と本文のカウントを確認する回帰テストを追加

[0.1.9] - 2026-08-30

• 分割表示でどのペインを編集しているか分かるように、アクティブなペインの強調を追加
  • 強調スタイル（枠線 / 左端のバー）、強調色、太さを設定できます
  • カーソル行の強調を追加（既定はオフ）
  • 既定では、表示中のエディタが2つ以上あるときだけ強調します

[0.1.8] - 2026-08-18

• コミュニティプラグインの自動レビューの指摘に対応（挙動の変更なし）
  • DOM生成をObsidianの createSpan / createEl / createFragment に統一
  • ビルド設定の builtin-modules 依存を Node 標準の node:module に置き換え
  • 正規表現内の全角スペースをエスケープ表記に変更、不要なエスケープを削除
  • 設定の読み込みに型を付与、未使用の定数を削除

[0.1.7] - 2026-08-18

• READMEに英語のドキュメント（機能概要・インストール・使い方・設定・プライバシー）を追加

[0.1.6] - 2026-08-18

• Obsidianコミュニティプラグイン申請に向けてリポジトリを整備
  • MITライセンスの LICENSE を追加
  • 設定画面の見出しをObsidian標準の見出し表示に変更
  • プラグインを無効化したときにルビサイズ用のCSS変数を後始末するよう修正

[0.1.5] - 2026-08-10

• 行末の改行マーク（↵）を禁則処理のぶら下げ表示に変更
  • 行が右端まで埋まったときに、改行マークだけが次の行へ折り返されてしまう問題を修正

[0.1.4] - 2026-06-25

• 見出しセクションのコピーコマンドの対象範囲を拡張
  • 見出しが1つもないファイルでは全文をコピー
  • カーソルが最初の見出しより前（前文）にある場合は、先頭から最初の見出しの直前までをコピー

[0.1.3] - 2026-06-23

• カーソルが属する見出しセクションをクリップボードにコピーするコマンドを追加
  • Copy current section (with heading)（見出し行を含む）
  • Copy current section (without heading)（見出し行を除く）
  • いずれも配下の小見出しを含めてコピーします

[0.1.2] - 2026-06-10

• 空白（全角スペース・タブ）と改行を可視化する機能を追加（それぞれ設定でオン/オフ可能、既定はオフ）

[0.1.1] - 2026-06-10

• 長文ファイルでの動作速度を改善
  • ルビ/傍点の解析処理を書き換え、文字数カウントを大幅に高速化
  • 編集中のキー入力ごとに全文を再解析していた見出しカウント処理を、変更行のみの差分処理に変更
  • ファイルを開く・ペインを切り替えるたびに全エディタの表示を再構築していた処理を軽量化
• 複数行テキストの行頭にあるルビで、直前のテキストが文字数カウントやプレビューから失われる不具合を修正

[0.1.0] - 2026-06-09

• Initial release