ノートとMarkdown

最終更新: 2026-08-14

Plainvaの各ノートは、ごく普通のMarkdownファイル（.md）です。このページでは、快適に書く方法と、実際にファイルに何が保存されるのかを説明します——これこそが、あなたのノートをポータブルにする理由です: どんなテキストエディター、Obsidian、あるいはGitのdiffでも読むことができます。

基本原則: すべてはテキストである

Plainvaで見えているもの——書式付きテキスト、テーブル、プロパティ、アイコン——は、すべてオープンなテキストとして保存されます。

---
type: Note
okf_version: "0.1"
tags: [project]
plainva:
  icon: "🚀"
  header_color: "#2f6f6f"
---
# My Project

A **bold** thought with a link to [[Another Note]].

- [ ] First task

---の行に挟まれたブロックがFrontmatter（YAML）です: ここにノートのプロパティが保存されます。その下には通常のMarkdownテキストが続きます。Plainva独自の表示設定（アイコン、ヘッダーカラー）はplainva:という1つのキーの下にまとめられています——他のプログラムは単にそれを無視します。

ライブプレビューで書く

ライブプレビューはデフォルトのモードです: 入力するとMarkdownがレンダリングされますが、常に編集可能な状態が保たれます。

スラッシュメニュー

行頭で/を入力すると、挿入メニューが開きます。セクションごとにグループ化されています。

• 基本ブロック——テキスト、見出し1〜6、箇条書きリスト、番号付きリスト、To-doリスト、引用、コードブロック、テーブル、区切り線、数式 (LaTeX)、Mermaid 図
• 書式設定——太字、斜体、取り消し線、インラインコード、ハイライト、絵文字
• リンクとメディア——リンク、内部リンク、画像（Web）、内部画像、埋め込み、データベースを埋め込む、インラインデータベースを作成
• ドキュメント——ドキュメントアイコン、ヘッダーカラー、テンプレートを挿入
• コールアウト——13種類のバリエーション（ノート、情報、To-do、要約、ヒント、成功、質問、警告、失敗、危険、バグ、例、引用）

その他の執筆サポート機能

• 選択ツールバー——テキストを選択すると、小さなバーが表示され、太字、斜体、取り消し線、インラインコード、ハイライト、リンクを提供します。
• @メンション——テキスト内のどこでも@を入力すると、日付（今日、明日、昨日、または日付を選択…、ISO形式の日付として保存されます）、ノートへのリンク、またはデータベースの埋め込みを挿入できます。
• 絵文字——スラッシュコマンドの絵文字（/emoji）はカーソル位置に絵文字ピッカーを開きます。あるいは:name（例えば:rocket）と入力するとインライン候補が表示されます。いずれの方法でも、Plainvaは実際の絵文字文字（ポータブルなUnicode）を挿入し、:shortcode:は使いません——そのため、ノートはObsidian、GitHubなど、どこでも読みやすいままです。（これは、Frontmatterに保存されるノートのドキュメントアイコンとは別のものです。）
• ブロックハンドル——各段落の左側にカーソルを合わせるとハンドルが表示されます: ドラッグしてブロックを移動したり、クリックしてブロックの操作メニューを開いたりできます（変換先 テキスト/見出し/リスト/To-do/引用/コードブロック、複製、上に移動/下に移動、ブロックを削除）。同じ種類のリストの隣にリストをドラッグすると、Plainvaは目に見えない区切り行<!-- -->を挿入し、2つのリストが分かれた状態を保ちます——Markdownでは、空行があっても同じ形式のリストは通常結合されてしまうためです（Obsidianでも同様です）。
• テーブル——クリックで編集できるセルを持つウィジェットとして表示されます。セルの表示では書式（太字、斜体、コード、ハイライト）、クリック可能なリンク（[[内部リンク]]、Webアドレス）、そして<br>が改行としてレンダリングされます。編集中は生のテキストが表示されます。テーブルメニューでは行・列の挿入/削除、および配置（左揃え/中央揃え/右揃え）ができます。
• リストは自動継続され（Enterで次のリストマーカーが挿入されます）、コードブロックは言語に応じてハイライト表示され（閲覧モードでも）、貼り付けたコンテンツはMarkdownに変換され（スマートペースト）、見出しは折りたたむことができます。
• 現在のノート内の検索と置換: Ctrl+F（検索を参照）。

リンクとバックリンク

• 内部リンク: [[ノート名]]（Wikiリンク）——スラッシュメニューまたは@を使い、組み込みのノート検索で入力できます。従来のMarkdownリンク[テキスト](パス.md)も機能します。
• まだ存在しないリンク先: まだ作成されていないノートへのWikiリンクは、淡色の破線の下線で表示されます（ライブプレビューと閲覧モードの両方で）。クリックするとノートが作成され、開かれます——現在のノートのフォルダーに置かれます（リンクにパスが含まれている場合は、そのパスに置かれます。例: [[フォルダー/新規ノート]]）。作成前に確認を求めたい場合は、設定 → アプリ → エディタとノート → リンク → 空のリンクを作成する前に確認するを有効にしてください。
• バックリンク: 右サイドバーのバックリンクセクションには、アクティブなノートにリンクしているノートが表示されます——ソースファイルごとにグループ化され、複数の出現がある場合はカウンターが表示されます。
• リンクを維持した名前変更: ファイルツリーでファイルの名前を変更すると、Plainvaは保管庫全体でそのファイルへのすべてのリンクを更新し（#Sectionのようなアンカーも保持されます）、次のように報告します: 「N件のリンク（M件のファイル内）が新しい名前に更新されました。」

プロパティ（Frontmatter）

右サイドバーのプロパティセクションには、ノートのFrontmatterがフォームとして表示されます。プロパティを追加で新しいプロパティを作成できます。各プロパティにはフィールドタイプがあります。

選択タイプは色と（ステータスの場合）グループ/段階を持つ固定の選択肢を持つことができます——これらの選択肢リストはデータベース（.base）で管理されます。詳しくはデータベース (.base)を参照してください。

2つのフィールドは保護されています: typeとokf_versionはPlainvaによって管理されるOKFシステムフィールドです——typeの値は既知のタイプのドロップダウンから選択でき、名前/フィールドタイプ/削除はロックされています（背景: OKF）。

ドキュメントアイコンとヘッダーカラー

各ノートは、アイコン（Notion風にタイトルの上に表示され、タブとファイルツリーにも表示されます）と、全幅の色の帯を持つことができます。

• ライブプレビューでタイトルの上にカーソルを合わせると: アイコンを追加 / ヘッダーカラーを追加（後で: アイコンを変更 / ヘッダーカラーを変更）——または、スラッシュコマンドのドキュメントアイコンとヘッダーカラーを使用します。
• アイコンピッカーには絵文字とアイコンの2つのモードがあり、操作は同じです。共通のヘッダー、共通の検索、どちらのモードにもカテゴリー（タブ）と最近使ったものがあり、再起動後も残ります。
• アイコンセットは10のカテゴリーに分けた約400個の厳選アイコンです（知識とファイル、仕事とタスク、技術、人と連絡、制作とメディア、暮らしと家、自然と天気、旅行と場所、お金と数字、記号と状態）。検索は名前とキーワードに当たります。
• アイコンモードでは上部で色を選びます。ヘッダーの帯と同じパレットで、A が既定の色、カスタム色… で自由な値を指定できます。選んだ色は、その後にタップしたアイコンに適用されます。
• どちらもFrontmatterのplainva:（icon、icon_color、header_color）の下に保存されます——純粋な表示設定であり、他のプログラムには影響しません。

テンプレート

設定 → 保管庫 → コンテンツと構造（入力欄の横の フォルダーを選択… で保管庫内のフォルダーを直接選べます）でテンプレートフォルダーを設定します。その後、Ctrl+Alt+Tまたはスラッシュコマンドのテンプレートを挿入でテンプレートを挿入できます。テンプレートは、Frontmatterを含めて新規ファイルの内容を完全に定義します。テンプレートが独自のtypeを持っている場合は、テンプレートが優先されます。既存のノートに挿入する場合、テンプレートのfrontmatterは省略され、内容のみが挿入されます。

プレースホルダー: テンプレートは名前付きのプレースホルダーを埋め込みます——スクリプトも式もありません。どれもコードを実行しません。

テンプレートが何かを尋ねる場合、Plainvaはノートが書き込まれる前にすべてを1つのダイアログでまとめて尋ねます——挿入する場合も作成する場合も同様です。キャンセルすれば何も作成されません。バックグラウンドで作られるノート（タスク同期など）だけは尋ねられず、そこでは回答は空のままです。Plainvaが認識しないプレースホルダーはそのまま表示され続けます——そのため、誤入力は誤入力として見えます。

スマートフォンでも同じエンジンが動きます: プレースホルダーは置き換えられ、テンプレートの質問は1つのシートにまとめて表示され（キャンセルすると何も作成されません）、フォルダー → テンプレートとノートの種類 → テンプレートの割り当てもそこで適用されます——そのためProjekte/のノートはどちらの端末でも同じように始まります。2つの違いがあります: 割り当てはデスクトップで行われ（スマートフォンはそれを適用するだけです）、{{weekday:…}}はそこでは常に月曜日から数えます。週の始まりの設定がモバイルにはまだ存在しないためです。

テンプレート自身のための設定: テンプレートには、テンプレート自身にだけ当てはまる設定を持たせられます。たとえば、そのタスクをタスク一覧に出さないことや、どのデータベースに属するかです。そこから作成したノートはこれらを引き継ぎません。非常に古いデイリーノートには、まだ残っていることがあります。見つけ方はFAQで説明しています。

フォルダーごとのテンプレート: 設定 → 保管庫 → コンテンツと構造 → テンプレートで、フォルダーにテンプレートを割り当てられます——そこに作成される新しいノートは、何も選ばなくても自動的にそのテンプレートから始まります。この割り当てはサブフォルダーにも適用され、複数が一致する場合は最も長いパスが優先されます（プロジェクト/クライアントはプロジェクトより優先されます）。同じように、テンプレートをノートの種類に割り当てることができます。その割り当ては、フォルダーにルールがない場合にのみ適用されます——フォルダーがタイプより優先されます。テンプレートから新規ノート…（ファイルツリーでの右クリック、コマンドパレット、クイックスイッチャーのいずれかから）を使えば、テンプレートを明示的に選べます——これはどの割り当てよりも優先されます。割り当ては設定の中にあり、ノートの中にはなく、設定の同期を通じて他のデバイスにも引き継がれます。

テンプレートの作成はどこからでも行えます: コマンドパレット（Ctrl+P）には新規テンプレートを作成（新しいテンプレートが編集のために開きます）と現在のノートをテンプレートとして保存（開いているノートをテンプレートフォルダーにコピーします）があります。テンプレートはごく普通のMarkdownファイルです——ファイルツリーで直接編集、名前を変更、削除できます。

デイリーノート

デイリーノートを開く（サイドバー）、またはカレンダーをクリックすると、設定したデイリーノート形式の日付フォルダーに、任意のテンプレートから今日のノートが作成されます。

タスク、数式、図、脚注

• タスクのチェックボックス: - [ ] タスクはどこでもチェックボックスとして表示されます——そして閲覧モードではそれをクリックできます: Plainvaは[x]または[ ]をファイルに書き戻します。

• 数式（LaTeX）: インラインの$E = mc^2$とブロックの$$…$$は、閲覧モードとライブプレビューの両方で数式としてレンダリングされます（KaTeX）。カーソルが数式の中にあるときは記法が表示され、レンダリングされた数式をクリックすると編集のために開きます。記法が常にそのまま表示されるのはソースモードのみです。$$…$$ブロックを覚えておく必要はありません——スラッシュコマンドの数式 (LaTeX)（/katex）がそれを挿入し、カーソルをその中に配置します。

• Mermaid図: 言語をmermaidとしたコードブロックは（最も速いのはスラッシュコマンドのMermaid 図、/mermaid）、閲覧モードとライブプレビューの両方で図として描画されます——図をクリックすると編集のためにコードが表示されます。

  ```mermaid
  graph TD
    Idea --> Note --> Knowledge
  ```

• 脚注: 本文[^1]と、末尾の[^1]: 脚注の内容。——閲覧モードでは参照と脚注一覧がジャンプマーク付きでレンダリングされます。最も速いのはスラッシュコマンドの脚注（/footnote）です: 次の空いている参照番号を挿入し、ノート末尾の定義へ直接ジャンプします。

印刷とPDFとして保存

エディターの**⋮メニューとコマンドパレット（Ctrl+P）には印刷 / PDF として保存…**があります: 印刷は常に閲覧ビューを使用します（ライブ/ソースモードからの場合、Plainvaは先にそちらへ切り替えます）。システムのダイアログでは、プリンターの代わりに「PDFとして保存」を選択できます。

ノートのエクスポート

• Markdown としてエクスポート…（エディターの**⋮**メニューまたはコマンドパレット）: システムのダイアログを通じて、ノートのコピーを任意の場所に保存します——たとえば別のプログラムに渡す場合などです。リンクされた添付ファイル（画像など）はエクスポートされません——ノートがそれらを参照している場合、Plainvaは短い通知を表示します。
• PDF: 上記の**印刷 / PDF として保存…**を使い、システムのダイアログで「PDFとして保存」を選択します。

別のエディターでノートを開く

あなたのノートは普通の.mdファイルなので、どんなMarkdownエディターでも開くことができます。エディターの**⋮メニューには既定のアプリで開く**があり、現在のノートをシステムがMarkdownファイルに関連付けているアプリ（Byword、MacDown、VS Codeなど）に渡します。Plainvaはそのファイルを監視し続けるため、そちらで行った編集はこちらに自動的に反映されます。

画像と添付ファイル

• 挿入: スラッシュコマンドの内部画像（保管庫から検索して埋め込む）または画像（Web）（URLを使用）。ほかにも、クリップボードからファイルを貼り付ける（Ctrl+V）だけでも構いません。画像はもちろん、PDF や表計算ファイルでも同じです。また、ファイルエクスプローラーからエディターへファイルをドラッグすることもできます: 画像は埋め込まれ（![[…]]）、それ以外のファイルはコピーされてリンクされます（[[…]]）。 これらのファイルの保存先は設定です: 設定 → 保管庫 → 内容と構成 → 添付ファイルのフォルダー（既定は Attachments、フォルダー ブラウザー付き）。空にすると、この設定ができる前の Plainva と同じようにノートの隣に保存されます。フォルダーは設定の同期で移動するため、パソコンとスマートフォンは添付ファイルを同じ場所に置きます。
• ファイルを添付…: スラッシュコマンドの**ファイルを添付…と、ノートの⋮メニューにある同じ項目が、システムのファイルダイアログを開きます。スマートフォンでは＋シートの端末のファイル…**にあります。ファイルは添付ファイルのフォルダーにコピーされ、画像は埋め込まれ（![[…]]）、それ以外はリンクされます（[[…]]）。
• リンク: [[ と入力すると、Plainva はまずノートを、その下の添付ファイルには保管庫のファイルを提案します。
• 表示: 画像ファイル（PNG、JPG、GIF、WebP、SVG、BMP、AVIF）は、組み込みの画像ビューアーで拡大/縮小、画面に合わせる、**実際のサイズ（1:1）**とともに開きます。
• 編集: 編集ボタンで、画像エディターが切り抜き、回転/反転、サイズを変更、描画ツール（ペン、矢印、長方形、テキスト）、そして元に戻す/やり直すとともに開きます。その場で保存するか、**コピーとして保存…**できます。編集可能な形式はPNG、JPG、WebPです。その他の形式は表示専用で開きます。
• テキストファイルは Plainva 内で開きます（.txt、.csv、.json、.yaml、ソースコードなど）。保管庫にさらに必要なら、設定 → 保管庫 → 内容と構造 → その他のテキストファイルに拡張子を追加してください。この一覧は追加のみで、何かを取り除くことはありません。ファイルの先頭がテキストでないと示した場合、Plainva は表示せず既定のプログラムを提案します。表示して保存するとファイルが壊れるからです。こうして開いたファイルは保存時に改行コードと BOM をそのまま保ちます — あなたのファイルであって、Plainva のものではありません。編集中、Plainva はファイルの拡張子に応じてテキストに色を付けます — ノート内のコードブロックが受けるのと同じハイライト表示です。ノートのツールはすべてオフになります: ライブプレビュー、プロパティヘッダー、[[links]]、”/“メニューのいずれもありません。検索と置換は残ります。テキストの機能であり、ノートの機能ではないためです。
• その他の添付ファイルは、クリックでシステムの既定のプログラムで開きます。ファイルツリーからでも、[[リンク]]・ブックマーク・検索からでも同じです。

Obsidianはどうなるのか？

すべては標準のFrontmatterを持つ標準的なMarkdownのままです。Obsidianはこれらのファイルを完全に開くことができます。バンドルされたplainva:キーは、プロパティパネル内で編集不可のオブジェクトとして表示されます——これは意図的なもので、害はありません。

関連ページ

• データベース (.base)——ノートをテーブル、ボード、カレンダーとして
• OKF——typeとokf_versionが何を意味するか
• 検索とキーボードショートカット

選択範囲の書式設定

選択範囲が複数行にまたがる場合、太字、斜体、取り消し線、ハイライト、インラインコードは空でない各行に個別に適用されます。リスト、引用、見出し、タスクの接頭辞はインライン記号の外側に保たれます。複数行のリンクラベルは可搬性のある Markdown ではないため、リンクは1行に限定されます。

ATX 見出しと GFM タスクは互いに排他的なブロック形式です。そのため Plainva は無効な混在形式を書き込みません。どちらでもインライン書式を利用でき、- [ ] **重要なタスク** のようにタスク名を強調できます。