KuroEditor 操作マニュアル

記事を書く人のためのガイドです。ボタンの場所だけでなく、 知らないと戸惑うところ（改行と段落の違いや Tab がどこに効くかなど）を中心にまとめています。 組み込み方や API についてはトップページと GitHub の README をご覧ください。

画面の見かた

画面の上に、下の図と同じ 2 段のツールバーがあります。

このほかに、文字を選択したときだけ選択範囲の上（または下）に浮かぶメニューがあります。 文字装飾・見出し・リスト・コールアウトなどは、ここから使います。

文字数

本文の文字数が、ツールバー下段の右端に出ます。書くにつれて数字がリールのように回ります。 画面が狭くて下段に収まらないときだけ、上段の目次ボタンの左へ移ります。

• 数えるのは本文のテキストだけです（見出しやリストの文字も含みます）。
• 連続する空白・改行はまとめて 1 文字として数え、前後の空白は数えません。
• 絵文字や結合文字も見た目どおり 1 文字として数えます。

バージョン表示

エディターの版（v0.0.0 のような番号）は、ふつうは画面の左上のバッジに出ます。 ただし表示する場所はアプリ側の設定で決まっていて、画面の右下に出るアプリや、 まったく表示しないアプリもあります。 不具合を報告して頂くときにこの番号を添えて頂けると、原因がすぐ絞れて助かります。

3 つのモード

閲覧モードでリンクをクリックすると、いきなり移動せず 「このリンクを新しいタブで開きますか？」と確認が出ます。 読んでいる途中で記事から飛ばされないための動きです。

保存と元に戻す

• 保存 — タブバー右上の 保存。未保存の変更があるときだけ光ります。
• 自動保存 — チェックを入れておくと、編集が落ち着いたタイミングで自動的に保存されます。
• 元に戻す / やり直し — Ctrl/⌘+Z と Ctrl/⌘+Shift+Z（または Ctrl+Y）。連続して打った文字はまとめて 1 手として戻ります（最大 200 手）。

改行と段落 — Enter と Shift+Enter の違い

見た目はどちらも「次の行に移る」ですが、中身は別物です。 ここを知っておくと、後の字下げや装飾で戸惑わなくなります。

使い分けの目安は「意味のまとまりが変わるなら Enter、 同じ文の中で見た目を折り返したいだけなら Shift+Enter」です。 住所や詩のように「詰めて並べたい数行」は Shift+Enter が向いています。

文字の装飾

文字を選択すると出るポップアップメニューから操作します。

字下げ — Tab と Shift+Tab

Tab で 1 段（約 2 文字分）下げ、Shift+Tab で戻します。 行頭で Backspace を押しても 1 段戻ります。 複数行を選択していれば、選択にかかっている行すべてが動きます。

効く相手は決まっています。

箇条書き・番号付きリスト

複数行を選択してポップアップメニューのリストボタンから作ります。記号は後から選び直せます。

• 記号リスト（13 種） — ● ○ ■ - # * > ◎ ★ ☆ ▶ ▷ とチェックリスト。
• 番号リスト（7 種） — 1. ① (1) A. (A) ア (ア)。
• 行頭から作る — 行の先頭で 1. ＋スペースで番号リスト、記号＋スペースで記号リストになります。

階層（入れ子）にする

子リストの記号は、作られた時点では親から引き継ぎます。 あとから子リストだけ別の記号にしたいときは、その子リストの項目を選んで、 変えたい記号をクリックします（親の記号は変わりません）。 逆に親の項目を選んで押せば、親のリストだけが変わります。

番号付きリストを入れ子にしたときの番号

親の番号はそのまま続きます。子リストは 1 から始まり、 親のほうは子の分を数えません（下の例では、子の「刻む・炒める」を挟んでも 次の親項目は 3. です）。

Tab で項目を入れ子にすると、その項目は親の数え上げから外れるので、 後ろの項目は 1 つ繰り上がります（1・2・3 の 2 番目を入れ子にすると、 3 番目だった項目が 2. になります）。Shift+Tab で戻せば番号も元どおりです。

途中から番号を続ける・好きな番号から始める

説明の段落を挟んでリストを分けると、後ろのリストは 1 から始まります。 続きの番号にしたいときは、番号パネルの 「開始」に数字を入れます （そのリストの 1 番目が何番になるか、という指定です）。

• 「開始」はリストの中にカーソルがあるときだけ出ます（対象のリストが無ければ指定しようがないため）。
• 1 に戻すと指定は消えます（＝ふつうの 1 始まりに戻る）。
• 入れ子の子リストにも個別に指定できます（親の番号は変わりません）。
• 丸数字やカタカナなど、他の記号でも同じように効きます（開始 4 → ④）。

リストをやめる（「解除」は 2 段階）

1. 1 回目 — 記号だけが消えます。項目の位置と階層はそのまま。
2. 2 回目 — リストから抜けて普通の段落に戻ります。

深い階層の項目をいきなり段落に戻すと、左端まで飛び出して位置が分からなくなるための 2 段階です。 いまどちらの動きになるかは、ボタンにマウスを乗せると説明が出ます。

チェックリスト（Todo）

記号リストの記号のひとつです。マーカー選択パネルの ☑︎、または 行頭で [] ＋スペース（[x] ＋スペースなら最初からチェック済み）で作れます。

• チェックの切り替え — 箱をクリック / タップします。文字の上を押したときは普通にカーソルが立つので、編集の邪魔になりません。
• 普通の箇条書きと同じなので、Enter で次の項目・太字やリンクもそのまま使えます。
• 他の記号に切り替えてもチェックは消えません（見えなくなるだけで、☑︎ に戻せば復活します）。

コールアウト（囲み）

段落を選んでポップアップメニューから 💡 ヒント / ⚠️ 注意 / ❗ 警告 / 📌 メモ の 4 種類に変換します。 同じ種類をもう一度選ぶと解除、別の種類を選ぶと種類だけ変わります。

• 囲みの中で行を増やすときは Enter。行ごとに字下げや寄せをしたいなら必ず Enter で分けてください。
• 囲みから抜けるには、空行で Enter。囲みの下に新しい段落ができます。

角丸ボックス

で挿入します。中には普通に文章・画像・表などを入れられます。 カーソルがボックスの中にある間だけ、専用の BOX 設定メニューが浮きます。

コードブロック

• で挿入。行番号付きで、高さは中身に合わせて伸びます。
• 中では Tab / Shift+Tab がそのままインデントとして使えます。
• 右上の 📋 でコピー、その左の 🗑 で削除。
• 行番号の部分をドラッグすると、ブロックごと上下に移動できます。
• 公開ページでも行番号と 📋 コピーボタンが出ます（📋 はサイト側で読み込む小さなスクリプトが付けるので、出ない設定のサイトもあります）。

function hello(name) {
  return `こんにちは、${name}`
}

水平線

で挿入します。太さや点線を選べます。 水平線は「ここで区切る」ための線なので、画像や角丸ボックスの回り込みがあっても その下まで送られて、必ず横いっぱいに引かれます（＝水平線を入れると回り込みは終わります）。

表

から挿入します。KuroEditor の表はかなり細かく調整できます。

画像・動画・音声

入れ方は 3 通りです。

1. 🖼 からファイルを選ぶ、または URL を入力する
2. 本文にドラッグ＆ドロップする
3. クリップボードの画像をそのまま貼り付ける

画像・動画（mp4 / webm / mov）・音声（mp3 / wav など）に対応し、 YouTube や Vimeo の URL を入れると 16:9 の埋め込みになります。

挿入したメディアをクリックすると専用メニューが出て、その場で変えられます。

実際の表示（40%・右寄せ）

画像を 40%・右寄せにすると、このように文章が左側へ回り込みます。100% のままなら回り込みは起きず、画像の下に文章が続きます。

回り込みをここで終わらせたいときは、水平線を入れます。

リンクと URL カード

リンクを作る

を押すとリンク入力のポップアップが開きます。 先に文字を選択しておくと、その文字が表示テキストの初期値になります。 URL を入れずに閉じれば、本文には何も残りません。

リンクを直す

本文のリンクをクリックすると（移動はせずに）編集ポップアップが開き、URL と表示テキストを直せます。 右端の 🗑 でリンクを削除できます（文字は残り、リンクだけが外れます）。

URL カード

リンク編集ポップアップの「カード表示（表題なし）」にチェックを入れると、 青い文字リンクではなくカード（アイコン＋タイトル＋URL）で表示されます。 参考リンクを目立たせたいときに便利です。

絵文字

• 😊 からピッカーを開いて選びます。
• :smile: :fire: :+1: のようなショートコードを打つと自動で絵文字に変わります。

レシピカード

料理レシピを扱うサイト向けの機能です（サイト側で有効にしている場合だけ が出ます）。 人数・調理時間・材料・手順をまとめた 1 枚のカードとして本文に置けます。

• 編集はカードをクリックして開くモーダルから行います。
• 1 記事に 1 枚だけです。すでに 1 枚あるとボタンは灰色になり、理由が説明として出ます。

目次（見出しから自動生成）

本文に付けた見出しから、右側のパネルに目次が自動で作られます。 タブバー右上の か Alt+T で開閉、境目のドラッグで幅を変えられます。 見出しが 1 つも無い記事では自動的に隠れます。

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

閲覧モードでは、装飾と元に戻す系のショートカットは効きません。

困ったときは

コールアウトの中で Tab を押したら、全部の行が動いた

その囲みの中身が Shift+Enter で改行された1 つの段落になっています。 字下げは段落ごとに効くので全部動きます。行ごとに動かしたい場所は、改行を Enter で入れ直して段落に分けてください （改行と段落）。

囲みの中で Tab を押しても何も起きない

囲みの中身が段落になっていない（文字が直接置かれている）場合です。 その行を Enter で作り直すと字下げできるようになります。囲みそのものは Tab では動きません。

下に浮くメニューが出てこない

アプリの KuroEditor の設定によって、非表示にすることがあります。 同じ並びのボタンは上のツールバーの下段にもあるので、そちらから操作できます。

日本語の変換確定で Enter を押したら、変なことが起きる

変換確定の Enter は「文字の確定」として扱われ、改行やダイアログの確定には使われないようになっています。 もし変換確定でポップアップが閉じるなどの動きがあれば、それは不具合です。報告して頂けると助かります。

公開ページで、編集画面と見た目が違う

本文のスタイルは公開ページと共有しているので、基本的には同じに見えます。 違って見える場合は、サイト側のテーマの影響か、記事の保存が済んでいない可能性があります。

チェックリストを読者に押してもらいたい

公開ページのチェックは表示だけで、読者が押しても変わりません（チェックリスト）。 読者ごとの状態を保存する仕組みが必要なので、サイト側での対応になります。

間違って消してしまった

Ctrl/⌘+Z で戻せます。表の削除・リンクの解除・画像の削除など、 ボタンで行った操作もすべて履歴に残っています。