ノートとMarkdown

最終更新: 2026-07-22

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がフォームとして表示されます。プロパティを追加で新しいプロパティを作成できます。各プロパティにはフィールドタイプがあります。

グループ	タイプ
基本	テキスト、数値、チェックボックス、日付、日付と時刻
選択	選択、ステータス、複数選択
リストとリレーション	リスト、タグ、リレーション
Webと連絡先	URL、メール、電話

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

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

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

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

ライブプレビューでタイトルの上にカーソルを合わせると: アイコンを追加 / ヘッダーカラーを追加（後で: アイコンを変更 / ヘッダーカラーを変更）——または、スラッシュコマンドのドキュメントアイコンとヘッダーカラーを使用します。
アイコンピッカーには2つのモードがあります: 絵文字とアイコン（Lucideアイコンセット。色を選択可能）。
どちらもFrontmatterのplainva:（icon、icon_color、header_color）の下に保存されます——純粋な表示設定であり、他のプログラムには影響しません。

テンプレート

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

プレースホルダー: テンプレートは{{title}}（ノートのタイトル）、{{date}}、{{time}}を補完します。テンプレートを挿入する場合は、さらに2つが解決されます: {{cursor}}は挿入後にカーソルが置かれる位置を示し、{{prompt:Label}}は値を尋ねて（Labelとして表示）その回答を挿入します。テンプレートから新規ノートを作成する場合、{{cursor}}は取り除かれ、{{prompt:…}}は空欄のままになります。

テンプレートの作成はどこからでも行えます: コマンドパレット（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）だけでも構いません——ノートの隣に保存され、埋め込まれます。また、ファイルエクスプローラーからエディターへファイルをドラッグすることもできます: 画像は埋め込まれ（![[…]]）、それ以外のファイルはコピーされてリンクされます（[[…]]）。
表示: 画像ファイル（PNG、JPG、GIF、WebP、SVG、BMP、AVIF）は、組み込みの画像ビューアーで拡大/縮小、画面に合わせる、**実際のサイズ（1:1）**とともに開きます。
編集: 編集ボタンで、画像エディターが切り抜き、回転/反転、サイズを変更、描画ツール（ペン、矢印、長方形、テキスト）、そして元に戻す/やり直すとともに開きます。その場で保存するか、**コピーとして保存…**できます。編集可能な形式はPNG、JPG、WebPです。その他の形式は表示専用で開きます。
その他の添付ファイルは、ダブルクリックでシステムの既定のプログラムで開きます。

Obsidianはどうなるのか？

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

選択範囲の書式設定

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

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