問次郎

利用可能なブロック

本文で利用できるブロックの一覧と、それぞれの用途・操作を説明します。ブロックの追加方法はプロジェクト作成をご覧ください。

ブロックを追加・操作する

  • 追加する: 空の行で「/」を入力すると、ブロックの一覧が開きます。続けてブロック名の一部(例: 「どうが」「video」)を入力すると、絞り込めます。
  • メニューを開く: ブロックにマウスを重ねると、左に「⋮⋮」が表示されます。押すとメニューが開き、ブロックの種類の変換・複製・移動・削除や、下へのブロックの追加ができます。
  • 並べ替える: 「⋮⋮」をドラッグします。

文章のブロック

ブロック用途
テキスト通常の段落です。
見出し1〜3ページ内の区切りです。見出しは目次(下記)に表示されます。見出し1はページのタイトルと同じ大きさのため、通常は見出し2・3を使用します。
キャプション表や画像の下の注記など、小さく控えめな文字です。
引用ほかの文書からの引用です。下に出典を記載できます。
コードプログラムのコードや設定ファイルです。右上で言語を選択すると、色分けして表示します。

テキスト・見出し・キャプションは、メニューから左寄せ・中央寄せ・右寄せを選択できます。

文字を選択すると、太字・斜体・下線・取り消し線・コード・リンクを設定するメニューが表示されます。

改行を整える

テキスト・見出し・キャプションは、メニューの「改行を整える」をオンにすると、読みやすい位置で改行します。

  • 日本語は、言葉の途中で改行しません: 「ヘルプセン/ター」のように言葉が途中で分かれず、「ヘルプセンターです。」のような文節の区切りで改行します。
  • 最後の行に、1〜2文字だけ残りません: 段落の終わりで、文字が少しだけ次の行に送られるのを防ぎます。
  • 中央寄せのときは、行の長さをそろえます: 2行に分かれるときに、左右対称に近い形になります。
  • 英語の文章は、そのまま表示します: 英語は単語の区切りで改行されるため、言葉の途中で分かれることはありません。

トップページのキャッチコピーや見出し、短い紹介文など、大きな文字や中央寄せの短い文章に適しています。長い本文の段落は、オフのままにしておくことをおすすめします。

初期状態では、すべてのブロックでオフです。設定はブロックごとで、公開ページ・プレビュー・編集画面のいずれでも同じように改行されます。

リストのブロック

ブロック用途
箇条書きリスト順番のない項目の並びです。
番号付きリスト手順など、順番のある項目の並びです。
ToDoチェックを付けられる項目です。確認事項のチェックリストなどに使用します。

項目の中で Tab キーを押すと、一段下げた入れ子にできます。

レイアウトのブロック

ブロック用途
コールアウト注意・補足・プランの条件など、目立たせたい内容です。左のアイコン(絵文字)を押すと、変更・削除できます。
折りたたみ見出しの1行だけを表示し、押すと中の内容を開く・閉じるブロックです。よくある質問の詳しい回答や、うまくいかないときの対処など、読み飛ばしてよい補足に使用します。
表比較や設定の一覧です。セルの中のボタンで行・列を追加し、メニューで先頭の行・列を見出しにできます。
カラム内容を横に並べます(2〜4列)。短い説明を並べるトップページなどに適しています。
タブ読者が切り替えて、1つだけを表示する内容です(例: プランごと・OS ごとの説明)。ラベルはその場で編集できます。
区切り線内容の区切りに引く線です。

コールアウト・引用・ToDo・折りたたみ・カラム・タブの中には、ほかのブロック(画像・動画・表など)を入れられます。ただし、カラムとタブの中に、カラムとタブは入れられません。

折りたたみ

折りたたみの1行目が見出しで、閉じていても表示されます。見出しの行で Enter キーを押すと、その下に中の内容を書けます。中に入れたブロックは、開いたときだけ表示されます。

公開ページの折りたたみの例。見出しの行「AI 追加枠は返金できますか?」が開いていて、中に「AI 追加枠は、購入後に返金できません。」と、閉じた状態の入れ子の折りたたみ「有効期限はありますか?」が表示されている。

公開ページの折りたたみ。見出しの行を押すと開き、中の内容が表示されます(下の「有効期限はありますか?」は、閉じた状態の入れ子の折りたたみです)。

  • 公開ページ: 最初は閉じた状態で表示します。読者が見出しの行を押すと、開きます。
  • 編集画面: 見出しの左の矢印を押すと、開閉できます。書きやすいよう、最初は開いた状態で表示します。開閉の状態は保存されません。
  • AI チャットと検索: 閉じていても、中の内容も読みます。
  • 入れ子: 折りたたみの中に、折りたたみを入れられます。
読者全員に必要な情報(手順や注意事項など)は、折りたたみに入れずに本文に記載してください。見出しの行には、中に何が書かれているかが分かる文を記載します。

メディアのブロック

ブロック用途
画像スクリーンショットなどの画像です。押すと、画像の差し替えや代替テキストの変更ができます。
動画YouTube・Vimeo・Loom の動画を埋め込みます。動画の URL と、キャプション(動画の説明)を入力します。
リンクカードほかのサイトへのリンクを、タイトル・説明・画像付きのカードで表示します。
ダイアグラムフローチャートやシーケンス図などの図を、Mermaid の記法で書いて表示します(下記)。

画像と動画は、マウスを重ねると表示される左右のつまみをドラッグして幅を変更し、右上のボタンで左寄せ・中央寄せ・右寄せを選択できます。つまみをダブルクリックすると、元の大きさ(動画は本文の幅いっぱい)に戻ります。

画像・動画の内容は文章でも記載してください

AI チャットは、画像の中の文字や動画の内容を読み取れません。画像には代替テキストを、動画にはキャプションを付け、重要な手順は本文にも記載しておくと、AI チャットが質問に回答しやすくなります。

ダイアグラム

ダイアグラムは、Mermaid の記法で書いた図を表示するブロックです。空の行で「/」を入力し、「ダイアグラム」を選択して追加します(「mermaid」「flow」と入力しても絞り込めます)。記法を入力すると、下に図のプレビューが表示されます。

例えば、次の記法を書くと、その下の図が表示されます。

テキスト
flowchart LR
  A[ページを編集] --> B[プレビューで確認]
  B --> C{問題はない?}
  C -- はい --> D[公開]
  C -- いいえ --> A
Mermaid
flowchart LR
  A[ページを編集] --> B[プレビューで確認]
  B --> C{問題はない?}
  C -- はい --> D[公開]
  C -- いいえ --> A

上の記法から描いたダイアグラム。ページを編集し、プレビューで確認して、問題がなければ公開し、問題があれば編集に戻る流れを表しています。

  • 書ける図: フローチャート、シーケンス図、状態遷移図、ガントチャートなどです。記法は Mermaid の公式サイトをご覧ください。
  • 記法が誤っている場合: 公開ページでは、図の代わりに記法をそのまま表示し、「図を描けませんでした」と表示します。編集画面では、プレビューの上に同じ知らせが表示されます。
  • 色: 白黒で表示します。テーマの色には合わせません。
  • 翻訳: 言語ごとに記法を翻訳できます。図の中の文字を翻訳するときに使います。
図の内容は文章でも記載してください

AI チャットは、図を見られず、記法の文字だけを読みます。図で示した流れや手順は本文にも記載しておくと、AI チャットが質問に回答しやすくなります。

ナビゲーションのブロック

ブロック用途
目次ページの見出しの一覧です。押すと、その見出しへ移動します。表示する見出しのレベルを選択できます。
ページツリーこのページの子ページの一覧です。章の入口のページに置くと、配下のページへ案内できます。表示する深さを選択できます。
ページカードプロジェクト内のほかのページへのリンクを、カードで表示します(ブロックのメニューから追加します)。
ページタイトルページのタイトルを、本文の任意の位置に表示します。1ページに1つだけ配置できます。

本文の途中に、ほかのページへのリンク(ページリンク)を入れることもできます(ブロックのメニューの「ページリンク」)。

AI チャットのブロック

ブロック用途
AI チャットの入力欄本文の中に、AI チャットへの質問の入力欄を配置します。入力して送信すると、チャットが開いて回答します。入力欄の案内文は変更できます。

例えば、次の入力欄に質問を入力して送信すると、チャットが開き、このドキュメントの内容をもとに AI が回答します。

AI チャットについてはAI チャットをご覧ください。