ナレッジの形式 — Markdown

アイノウのナレッジ（知識ベースの1ページ）は、すべて Markdown で保持します。これはアイノウのナレッジの持ち方の、最も基本的な考え方です。

かつての「テーブル型JSON」形式は廃止されました（2026年8月）。表データも Markdown のテーブル記法で持ちます。CSV / Excel を取り込むと Markdown のテーブルに変換されて保存されます（→ No.4.1）。

Markdown — すべてのナレッジの形式

説明・手順・FAQ・概念・統合ページ・早見表など、あらゆる内容を扱います。

見出しでセクションに分かれ、チャット回答時の検索単位（チャンク）になる。見出しを小さく区切る ほど検索（Query）精度が上がる
先頭に フロントマター（YAML 形式のメタ情報）を持ち、OKF に沿ったメタ情報になる（項目は下記「フロントマター」）
編集はブロック形式エディター（→ No.4.2）。Markdown のソースをそのまま書き込みたいときは .md ファイルのインポート（→ No.4.1）か MCP（→ No.6.1）を使う

制約

制約	内容
本文上限	262,144 文字 / 80,000 トークン
上限超過時	エディター保存・MCP 直接書込は超過でエラーになり保存できません。インポート時のみ上限以内に自動分割されます（タイトルに `(i/N)` が付く）
HTML	使用不可（本文中の生 HTML はエスケープされ、文字としてそのまま表示されます。例外はエディターの表セル内の装飾のみ）

図表を埋め込む拡張記法

コードブロックで図やグラフを描けます（チャット回答の見やすさが上がります）。

コードブロック	用途
`mermaid`	フロー・シーケンス・クラス・ER 図
`chart`	Chart.js のグラフ（line / bar / pie 等）
`gantt`	ガントチャート
`json`	配列の配列ならテーブル表示

手順は 表＋箇条書き、流れは mermaid、数値比較は chart が目安です。

mermaid のラベルはクォートする: ノードのラベル id[...] / id(...) / id{...} やエッジラベル |...| の中に丸括弧・角括弧・波括弧・記号・改行を含めるときは、必ずダブルクォートで囲みます（例: A["専門家 (あなた)"]）。クォートしないと構文エラーになり、図ではなくコードがそのまま表示されます。

なお言語名を付け忘れたり、flowchart のような図の種類を言語名にしてしまった場合でも、レンダラが中身から自動判定して描画を救済します。とはいえ確実性のため、上記の正しい言語名を付けてください。

表データの持ち方

列が決まったデータは Markdown のテーブル記法 で書きます。

CSV / Excel（.csv / .xlsx）を取り込むと Markdown のテーブルに変換される（1 ブック 1 ナレッジ。各シートが # {シート名} の H1 セクションになり、空シートはスキップ → No.4.1）
.json ファイル は、配列の配列であれば表に変換され、それ以外は json コードフェンスで包まれる
行の追加・更新は他の本文と同じく MCP の update-knowledge / append-knowledge、またはエディターの表ブロックで行う

フロントマター（OKF メタ情報）

ナレッジを エクスポート（ダウンロード） すると、本文の先頭に YAML フロントマター（--- で囲むメタ情報）が付与されます。これは Open Knowledge Format（OKF → No.10.2） に沿った形式で、インポート時にも読み取られます（既に先頭フロントマターがある場合は二重付与しない／空の項目は省略）。

項目	内容	OKF
`type`	本文形式。常に `markdown`	OKF キー（OKF は concept 種別、iknow は本文形式を表す）
`no`	章番号（例 `1.3`）	iknow 独自
`title`	タイトル	OKF
`tags`	タグ配列	OKF
`related_nos`	関連ナレッジの No 配列	iknow 独自（リンク復元用）
`timestamp`	最終更新日時（ISO8601）	OKF

書き方の指針

主に「読ませる文章」なら → 見出しで細かく区切った Markdown 本文
複数の資料を統合して概念ページを作るなら → Markdown 本文
列が決まったデータを並べるなら → Markdown のテーブル
流れ・関係・数値比較を示すなら → mermaid / chart / gantt

詳しい書き方は No.4.3（ナレッジの書き方と設計）、Markdown 記法の詳細は MCP の get-reference name=markdown-guide を参照してください。