- 技術 💻
Obsidianとは?使い方と保管庫の中身・同期・Git管理を実物で解説
結論
Obsidian(オブシディアン)は、パソコンの中のフォルダーに置いた Markdown ファイルを、リンクでつないで育てるメモアプリです。アプリ本体は仕事でも無料で使え、ノートはただの .md ファイルなので、アプリをやめても中身はそのまま残ります。
この記事でわかること
- 保管庫(Vault)と .obsidian フォルダーの中身をファイルの実物で
- [[ ]] リンク・タグ・プロパティの書き方と、ファイル上の保存のされ方
- 同期の選び方と料金、Git で管理する .gitignore とコンフリクトの実物
Obsidian の「保管庫」は特別なデータベースではなく、ふつうのフォルダーです。アプリはそのフォルダーの .md ファイルを読み、書かれているリンクやタグから、バックリンクやグラフを組み立てて表示します。
flowchart TD
V[保管庫 = ふつうのフォルダー] --> N[ノート .md・添付]
V --> O[.obsidian 設定]
N --> I[アプリが読み込み<br>リンク・タグから<br>バックリンクとグラフを表示]
よく調べられることの答えを先にまとめます。
| 知りたいこと | 答え | 詳しい節 |
|---|---|---|
| Obsidianとは | ローカルの Markdown ファイルをリンクでつなぐメモアプリ | Obsidianとは |
| Obsidian は無料? | アプリは仕事を含めて無料。同期(Sync)と公開(Publish)は有料 | 同期方法と料金 |
| Obsidian の使い方(最初の一歩) | 保管庫を作る→ノートを書く→[[ ]] でつなぐ | 基本の使い方 |
| 保管庫(Vault)とは | ノートを入れるフォルダー。中身は .md と .obsidian | 保管庫と .obsidian |
| リンク・タグの書き方 | [[ノート名]]、#タグ、先頭の --- で囲むプロパティ | 内部リンク/タグとプロパティ |
| スマホと同期したい | Obsidian Sync・iCloud・Git など。複数の方法を同時に使わない | 同期方法と料金 |
| Git で管理したい | workspace.json を .gitignore に入れる。コンフリクトに注意 | Git で管理する |
| Notion との違い | Obsidian は手元のファイル、Notion はクラウドのデータベース | Notion などとの違い |
確認環境:Ubuntu 24.04.5 LTS の上で、Obsidian の Linux 版 1.14.5(obsidian-1.14.5.tar.gz・公式の配布物)を作業用のフォルダーに展開し、ファイルの大きさ、同梱の Electron の版、アプリの資源ファイル(obsidian.asar)に入っている設定ファイル名と言語ファイルを読み取りました。アプリの起動はこの環境の権限で止められたため、画面の操作・設定の場所・ショートカットは Obsidian 公式ヘルプ(obsidian.md/help)で1つずつ確かめた範囲だけを書いています。保管庫は自分で作ったノートで組み、リンク・タグ・プロパティの読み取りは Python 3.13.18+PyYAML 6.0.3 の自作スクリプト、ほかのツールでの見え方は marked 18.0.10・pandoc 3.1.3・markdownlint-cli 0.49.0、Git での管理は Git 2.43.0 で実行しました。コミュニティプラグインの数とダウンロード数は公式リポジトリ obsidian-releases の公開ファイル、Dataview は公開されている配布ファイルで確かめています。料金は公式の Pricing・Sync のページ、図は mermaid-cli 11.16.0 で描画を確かめました(確認日 2026年10月29日)。
本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。
(記載例)出典:株式会社RJC「Obsidianとは?使い方と保管庫の中身・同期・Git管理を実物で解説」
Obsidianとは(何ができるメモアプリか)
この節では、Obsidian がどんなアプリで、ほかのメモアプリと何が違うのかが分かります。
Obsidian は、Markdown(記号で見出しや箇条書きを表す書き方)で書いたノートを、パソコンの中のフォルダーに保存し、ノート同士をリンクでつないで管理するアプリです。公式ヘルプは、ノートを「保管庫の中の Markdown 形式のプレーンテキストファイル」として保存し、保管庫は「ローカルのファイルシステム上のフォルダー」だと説明しています。
1ファイルが手元に残る
ノートは .md ファイル。アカウントを作らずに使え、アプリを消してもフォルダーの中身はそのまま読める。
2リンクでつなぐ
[[ノート名]] と書くだけで別のノートへ飛べる。逆向きの「バックリンク」も自動で一覧になる。
3プラグインで広げる
標準の機能(コアプラグイン)に加え、2026年10月29日時点で 9,660 本のコミュニティプラグインが登録されている。
「第二の脳」「PKM(個人の知識管理)」という言い方で紹介されることが多いのは、ノートを書きためるほどリンクが増え、関係が見えるようになるためです。用途は、日々のメモ・日報、学習ノート、読書メモ、技術メモ、議事録、個人の Wiki などです。
配布物の中身(実測)
公式の Linux 版を展開して大きさを測りました。中身は Electron(Chromium を使ったデスクトップアプリの仕組み)で作られたアプリで、アプリの本体のコードは obsidian.asar という1つのファイルにまとまっています。
$ grep -a -o -m1 'Chrome/[0-9.]* Electron/[0-9.]*' obsidian-1.14.5/obsidian
Chrome/150.0.7871.250 Electron/43.8.3
$ (obsidian.asar の package.json を読み取った結果)
{
"name": "obsidian-dev",
"description": "Obsidian",
"version": "1.14.5",
"license": "UNLICENSED",
...
}
package.json の license が UNLICENSED となっているとおり、Obsidian 本体はオープンソースではありません。無料で使えますが、ソースコードは公開されていない点が、オープンソースの Logseq などとの違いです。
Obsidianのインストール方法と日本語化
この節では、Windows・Mac・Linux・スマホでの入れ方と、画面を日本語にする設定の場所が分かります。
2026年10月29日時点の公式ダウンロードページの版は、デスクトップ版が 1.14.5、Android の APK が 1.14.4 です。
| OS | 公式の配布形式 | メモ |
|---|---|---|
| Windows | ユニバーサル インストーラー(.exe) | ダウンロードして実行する |
| Mac | ユニバーサル(.dmg) | Apple シリコンと Intel の両方に対応 |
| Linux | AppImage(x86_64・ARM64)、.deb(amd64)、Snap | Flatpak は Flathub でコミュニティが保守 |
| iPhone・iPad | App Store | 同期の方法を先に決める(後述) |
| Android | Google Play、APK | APK は公式ページから |
公式サイトからダウンロードする
obsidian.md の Download ページで OS に合うものを選ぶ。アカウント登録は要らない。
保管庫(Vault)を作る
最初の画面で新しい保管庫を作り、名前と置き場所(フォルダー)を決める。既にある Markdown のフォルダーを保管庫として開くこともできる。
日本語の画面にする
Settings(設定)→ General(一般)→ Language(言語)で日本語を選ぶ。配布物の i18n フォルダーに ja.txt が入っていることを確かめた。
最初のノートを1枚書く
新しいノートを作り、見出しと箇条書きを書く。保存ボタンは無く、書いた内容は自動でファイルに保存される。
Linux の AppImage は、実行の権限を付けてから起動します。.deb は sudo apt install ./obsidian_1.14.5_amd64.deb の形で入れられます。会社のパソコンでは、ソフトの導入ルールを先に確かめます。
保管庫(Vault)と.obsidianフォルダーの中身
この節では、保管庫がただのフォルダーであることと、設定フォルダー .obsidian に何が入るのかが、ファイルの実物で分かります。
記事用に作った保管庫の中身を、Obsidian を使わずに find と file で見ました。ノートは UTF-8 のテキスト、画像はふつうの PNG です。なお、この保管庫の .obsidian の JSON は、アプリを起動できなかったため、アプリのコードにあるファイル名で自分で置いた空のファイル(中身は {})で、Dataview だけは公開されている配布ファイルそのものです。
$ find . -type f -not -path './.git/*' | sort
./.gitignore
./.obsidian/app.json
./.obsidian/appearance.json
./.obsidian/community-plugins.json
./.obsidian/core-plugins.json
./.obsidian/hotkeys.json
./.obsidian/plugins/dataview/data.json
./.obsidian/plugins/dataview/main.js
./.obsidian/plugins/dataview/manifest.json
./.obsidian/plugins/dataview/styles.css
./.obsidian/types.json
./.obsidian/workspace-mobile.json
./.obsidian/workspace.json
./attachments/diagram.png
./daily/2026-10-29.md
./notes/Markdown.md
./notes/Vault.md
./templates/日報.md
$ file notes/Vault.md attachments/diagram.png
notes/Vault.md: Unicode text, UTF-8 text
attachments/diagram.png: PNG image data, 8 x 8, 8-bit/color RGB, non-interlaced
公式ヘルプによると、設定フォルダーの既定の名前は .obsidian で、保管庫の直下に作られます。ホットキー・テーマ・コミュニティプラグインなど、保管庫ごとの設定がここに入ります。名前が「.」で始まるため、Mac と Linux のファイル一覧では隠しフォルダーとして表示されません。
.obsidian に入るファイル(アプリのコードから確認)
公式ヘルプは設定フォルダーの中のファイルを一覧にしていません。そこで、配布物の app.js(アプリのコード)に書かれているファイル名を読み取り、公式ヘルプの説明と合わせて役割を整理しました。
| ファイル | 入るもの | Git・同期での扱い |
|---|---|---|
| app.json | エディタ・ファイルとリンクなどの設定 | 共有してよい |
| appearance.json | テーマ・フォント・CSS スニペット | 共有してよい |
| core-plugins.json | どのコアプラグインを有効にしたか | 共有してよい |
| community-plugins.json | 有効にしたコミュニティプラグインの ID | 共有してよい |
| hotkeys.json | 自分で変えたショートカット | 共有してよい |
| types.json | プロパティの型(日付・数値など) | 共有してよい |
| workspace.json | 開いているタブ・ペインの配置 | 端末ごとに変わる。Git では除外が多い |
| workspace-mobile.json | スマホでの画面の配置 | 同上 |
| plugins/(ID名)/ | main.js・manifest.json・styles.css・data.json | data.json に API キーを入れるプラグインに注意 |
(obsidian.asar の app.js に書かれていた .json のファイル名・抜粋)
app.json
appearance.json
community-plugins.json
core-plugins.json
data.json
hotkeys.json
manifest.json
types.json
workspace-mobile.json
workspace.json
グラフビューやデイリーノートなど、コアプラグインの設定は「プラグインの ID+.json」の名前で作られます(graph.json・daily-notes.json など。app.js に固定の文字としては書かれておらず、ID から組み立てる形でした)。
保管庫の外にある「アプリ全体の設定」
どの保管庫を開いたかの一覧など、アプリ全体の設定は保管庫の外に保存されます。公式ヘルプの場所は次のとおりです。
| OS | アプリ全体の設定の場所 |
|---|---|
| Windows | %APPDATA%\Obsidian\ |
| Mac | /Users/ユーザー名/Library/Application Support/obsidian |
| Linux | $XDG_CONFIG_HOME/obsidian/ または ~/.config/obsidian/ |
設定フォルダーの名前は、設定 → ファイルとリンク → Override config folder で変えられます(変えた後はアプリの再起動が要り、前のフォルダーの設定は引き継がれません)。端末ごとに別の設定を使いたいときの仕組みです。
Obsidianの基本の使い方(ノート作成・表示モード・ショートカット)
この節では、ノートの書き方、3つの表示モードの違い、最初に覚えるショートカットが分かります。
ノートは Markdown で書きます。見出しは # 、箇条書きは - 、チェックボックスは - [ ] 、太字は **文字** です。記法の一覧は、関連記事「Markdownの書き方一覧|記法早見表と環境別の対応・変換結果つき」で扱っています。
編集するとき
ライブプレビュー:書式を見ながら書ける(既定)。カーソルを置いた所だけ記号が出る
ソースモード:Markdown の記号をすべてそのまま表示する
既定は 設定 → エディタ → Default editing mode
読むとき
閲覧ビュー(Reading view):記号を隠して読みやすく表示
右上の切り替えボタンか Ctrl+E(Mac は Cmd+E)
どのモードでもファイルの中身は同じ
最初に覚えるショートカット(公式ヘルプで確認)
| 操作 | Windows・Linux | Mac |
|---|---|---|
| コマンドパレット(何でも呼び出す) | Ctrl+P | Cmd+P |
| クイックスイッチャー(ノートを開く・作る) | Ctrl+O | Cmd+O |
| 保管庫全体を検索 | Ctrl+Shift+F | Cmd+Shift+F |
| 閲覧ビューと編集の切り替え | Ctrl+E | Cmd+E |
| 元に戻す・やり直し | Ctrl+Z・Ctrl+Shift+Z | Cmd+Z・Cmd+Shift+Z |
クイックスイッチャーで、まだ無い名前を入れて Enter を押すと、その名前のノートができます。似た名前があっても、入れたとおりの名前で作りたいときは Shift+Enter です。ショートカットは 設定 → ホットキー で確かめ・変更でき、コマンドパレットにもショートカットが表示されます。
ターミナルから操作する(Obsidian CLI)
公式ヘルプによると、Obsidian 1.12 のインストーラーから、ターミナルで操作する CLI が使えます(設定 → 一般 で有効にし、案内に沿って登録)。アプリが起動している必要があり、obsidian daily(今日のデイリーノートを開く)、obsidian search query="..." などのコマンドがあります。配布物にも obsidian-cli という小さな実行ファイル(18KB)が入っていました。
内部リンク・バックリンク・埋め込みの書き方
この節では、[[ ]] で書く内部リンク、自動でできるバックリンク、ほかのノートや画像の埋め込みの書き方と、それがファイルにどう残るかが分かります。
記事用のノート Vault.md の中身です。リンクも埋め込みも、ファイルの中ではただの文字です。
---
tags: [用語]
status: 完了
rating: 4
---
# Vault
保管庫はただのフォルダーです。詳しくは [[Markdown#見出しの例|見出しへのリンク]] を見ます。
![[Markdown#見出しの例]]
![[diagram.png]]
- [ ] Git で管理する #todo
- [x] 保管庫を作る
まだ無いノートへのリンク:[[同期の方法]]
| 書き方 | 意味 | 例 |
|---|---|---|
| [[ノート名]] | 別のノートへのリンク(.md は省略可) | [[Markdown]] |
| [[フォルダー/ノート名]] | 保管庫の直下からのパスで指定 | [[notes/Markdown]] |
| [[ノート名#見出し]] | 見出しへのリンク | [[Markdown#見出しの例]] |
| [[ノート名#^ID]] | 段落(ブロック)へのリンク | [[2026-10-29#^abc123]] |
| [[ノート名|表示名]] | 表示する文字を変える | [[Markdown|記法のまとめ]] |
| ![[ノート名]] | ノートの中身を埋め込む(見出し・ブロック単位も可) | ![[Markdown#見出しの例]] |
| ![[画像|幅x高さ]] | 画像の埋め込み。幅だけなら比率を保つ | ![[diagram.png|100]] |
まだ無いノートへのリンク(例の [[同期の方法]])も書けます。公式ヘルプによると、そのリンクを開くと、そのノートが作られます。先にリンクだけ置き、後で中身を書く使い方ができます。PDF は #page=3 でページを指定して埋め込めます。
バックリンクはファイルに保存されない(実測)
Obsidian の「バックリンク」は、ほかのノートのリンクを集めて表示する機能です。ファイルに書かれているのは「出ていくリンク」だけで、逆向きの一覧は保管庫を読み込んで計算されます。同じ計算を Python のスクリプトで行いました。
$ python3 index.py vault
== 発リンク(ファイルに書かれているもの)
2026-10-29 -> Vault
2026-10-29 -> Markdown
Markdown -> Vault
Vault -> Markdown#見出しの例
Vault -> Markdown#見出しの例 (埋め込み)
Vault -> diagram.png (埋め込み)
Vault -> 同期の方法 [未作成]
== バックリンク(Obsidian が計算して表示するもの)
Markdown <- 2026-10-29, Vault
Vault <- 2026-10-29, Markdown
同期の方法 <- Vault
公式ヘルプは、バックリンクを2種類に分けています。リンクで参照している「Linked mentions(リンクされた言及)」と、ノートの名前が本文に出てくるのにリンクになっていない「Unlinked mentions(リンクされていない言及)」です。ノートの下にバックリンクを出すには、コマンドパレットで「Backlinks: Toggle backlinks in document」を実行するか、バックリンクの設定で「Backlink in document」を有効にします。
Markdown 形式のリンクにする設定
[[ ]] は Obsidian などで使われる書き方(Wikiリンク)で、標準の Markdown にはありません。ほかのツールでも読める形にしたいときは、設定 → ファイルとリンク の「Use [[Wikilinks]]」を切ると、[[ と打っても [表示名](ノート名.md) の形で入るようになります。空白は %20 に置き換わります。ブロックへのリンク(#^ID)は Obsidian 独自で、外では働きません。
ほかのツールで開くとどう見えるか(実測)
同じ Vault.md を、一般的な Markdown の変換ツールに通しました。[[ ]] はリンクにならず、文字のまま残ります。
$ marked -i notes/Vault.md (marked 18.0.10)
<hr>
<h2>tags: [用語]
status: 完了
rating: 4</h2>
<h1>Vault</h1>
<p>保管庫はただのフォルダーです。詳しくは [[Markdown#見出しの例|見出しへのリンク]] を見ます。</p>
<p>![[Markdown#見出しの例]]</p>
...
$ pandoc -f markdown+wikilinks_title_after_pipe -t html notes/Vault.md (pandoc 3.1.3)
<h1 id="vault">Vault</h1>
<p>保管庫はただのフォルダーです。詳しくは <a href="Markdown#見出しの例"
title="wikilink">見出しへのリンク</a> を見ます。</p>
1プロパティが見出しに化けた
marked は先頭の --- を区切り線、次の --- を見出しの下線と読み、プロパティ3行が h2 の見出しになった。
2[[ ]] は文字のまま
marked でも pandoc の既定でもリンクにならない。pandoc は wikilinks の拡張を付けるとリンクになった。
3チェックボックスは通じた
- [ ] と - [x] は、どちらのツールでもチェックボックスとして変換された。
ノートを社外の人に渡す・ブログに載せるなど、Obsidian の外で使う予定が多いなら、Markdown 形式のリンクに切り替えておくと手直しが減ります。
タグとプロパティ(YAML)の書き方
この節では、タグの書き方の決まりと、ノートの先頭に書くプロパティ(YAML の front matter)の型と保存のされ方が分かります。
タグの書き方
本文に #タグ名 と書くか、プロパティの tags に並べます。公式ヘルプの決まりは次のとおりです。
- 1空白は入れられない2語以上は camelCase や kebab-case(つなぎ線)でつなぐ
- 2数字だけのタグは無効#1984 は無効、#y1984 は有効。数字以外の文字が1つ以上要る
- 3/ で階層にできる#学習/obsidian のように書くと、#学習 の下の階層になる
- 4大文字と小文字は区別しない#tag と #TAG は同じ。一覧には最初に作った表記で出る
- 5プロパティの tags はリストで書くYAML の中では「- タグ名」の並びか [a, b] の形
記事用の保管庫から、本文のタグとプロパティの tags を集めた結果です。階層のタグ(#学習/obsidian)は親とは別の文字列としてファイルに残っています。
== タグ
#todo 2026-10-29, Vault
#学習 Markdown
#学習/obsidian 2026-10-29
#日報 2026-10-29
#用語 Vault
#記法 Markdown
プロパティ(YAML front matter)
プロパティは、ノートの先頭の --- と --- の間に「名前: 値」の形で書くデータです。コロンの後に半角スペースが要ります。ノートの画面ではフォームのように表示・編集でき、ファイルには YAML の文字として保存されます。
---
tags:
- 記法
aliases:
- マークダウン
status: 下書き
created: 2026-10-29
---
| 型 | 書き方の例 | 用途 |
|---|---|---|
| テキスト | status: 下書き | 状態・分類 |
| リスト | tags: [用語, 学習] | 複数の値 |
| 数値 | rating: 4 | 評価・件数 |
| チェックボックス | favorite: true | はい・いいえ |
| 日付 | created: 2026-10-29 | 作成日・期限 |
| 日付と時刻 | time: 2026-10-29T10:30:00 | 会議の開始時刻 |
| タグ | tags: (リスト) | tags 専用 |
既定のプロパティは tags・aliases(別名。リンクの候補に出る)・cssclasses の3つです。公式ヘルプによると、単数形の tag・alias・cssclass は 1.4 で非推奨になり、1.9 で既定のプロパティとしての扱いが無くなりました。以前のノートで単数形を使っていたら、複数形に直します。
プロパティを Python で読み取ると、日付は日付型、数値は数値型として返りました。型は保管庫の中で名前ごとに1つに決まり、.obsidian/types.json に保存されます。YAML の書き方の注意は、関連記事「YAMLの書き方|構文一覧とパース結果、落とし穴10例を実測」で扱っています。
== プロパティ
2026-10-29 {'date': datetime.date(2026, 10, 29), 'tags': ['日報']}
Markdown {'tags': ['記法'], 'aliases': ['マークダウン'], 'status': '下書き', 'created': datetime.date(2026, 10, 29)}
Vault {'tags': ['用語'], 'status': '完了', 'rating': 4}
グラフビュー・検索・Basesの使い方
この節では、ノートのつながりを図で見るグラフビュー、検索の演算子、ノートを表のように並べる Bases が分かります。
グラフビュー
グラフビューは、ノートを点、内部リンクを線にして描く機能です。リンクされている数が多いノートほど点が大きくなります。左のリボンの「Open graph view」で保管庫全体のグラフ、コマンド「Open local graph」で開いているノートの周りだけのグラフ(ローカルグラフ)が開きます。
| 設定 | 主な項目 | 使いどころ |
|---|---|---|
| Filters | Search files・Tags・Attachments・Existing files only・Orphans | 未作成のノートやリンクの無いノートを隠す |
| Groups | 検索語で選んだノートに色を付ける | タグやフォルダーで色分け |
| Display | Arrows・Node size・Link thickness・Animate | リンクの向きを見る |
| Forces | Center force・Repel force・Link force・Link distance | 密集をほぐす |
記事用の保管庫なら、Markdown と Vault が互いに結ばれ、日報(2026-10-29)から両方へ線が出て、未作成の「同期の方法」が薄い点で表示される形になります(上のスクリプトの発リンクと同じ関係です)。グラフは眺めて終わりにせず、どこからもリンクされていない「孤立したノート」を探す道具として使うと役に立ちます。
検索の演算子
| 演算子 | 意味 | 例 |
|---|---|---|
| file: | ファイル名を探す | file:2026-10 |
| path: | パスを探す | path:daily |
| tag: | タグを探す | tag:#todo |
| line: | 同じ行に含む | line:(Git 管理) |
| task-todo: | 未完了のタスクの中を探す | task-todo:Git |
| [名前:値] | プロパティの値で探す | [status:完了] |
公式ヘルプによると、tag:#work は #myjob/work には当たりません。ファイルがただのテキストなので、Obsidian の外でも grep で同じように探せます。3,000 ノートの保管庫で grep -rl '#t3x' notes は 0.018 秒で 429 件を返しました(後述の実測)。
Bases(データベースのような表示)
Bases はコアプラグインで、ノートとそのプロパティを、表(Table)やカード(Cards)の形で並べ、並べ替え・絞り込み・編集ができます。定義は .base ファイルとして保存するか、Markdown の中のコードブロックに埋め込みます。プロパティに status や rating を入れておくと、「status が下書きのノートだけを表にする」といった一覧が作れます。
デイリーノートとテンプレートの使い方
この節では、日付のノートを毎日作るデイリーノートと、決まった形を差し込むテンプレートの設定と変数が分かります。
デイリーノートを開く
リボンのカレンダーのアイコンか、コマンド「Open today's daily note」。今日のノートが無ければ作られる。
ファイル名は既定で YYYY-MM-DD
置き場所を決める
デイリーノートの設定の New file location に daily などのフォルダーを指定する。
形式を YYYY/MM/… にするとフォルダーも分かれる
テンプレートのフォルダー
設定 → コアプラグイン → テンプレート → Template folder location に templates を指定する。
デイリーノートの Template file location にも同じノートを指定できる
テンプレートを差し込む
リボンの Insert template か、コマンド「Templates: Insert template」。カーソルの位置に入る。
ホットキーを割り当てると速い
記事用の日報テンプレート(templates/日報.md)です。{{date}} などの変数は、差し込んだ時点の値に置き換わります。
---
date: {{date}}
tags: [日報]
---
# {{title}}
## やったこと
-
## 次にやること
- [ ]
| 変数 | 入るもの | 既定の形式 |
|---|---|---|
| {{title}} | 開いているノートの名前 | ― |
| {{date}} | 今日の日付 | YYYY-MM-DD |
| {{time}} | 今の時刻 | HH:mm |
| {{date:形式}} | 形式を指定した日付 | {{date:YYYY年MM月DD日}} など(Moment.js の書式) |
この形で書いたデイリーノート daily/2026-10-29.md(記事用に手で作成)は、次のとおりふつうの Markdown として残ります。条件分岐や計算をテンプレートで行いたい場合は、コミュニティプラグインの Templater が使われます(コアのテンプレートとは別のプラグインです)。
---
date: 2026-10-29
tags: [日報]
---
# 2026-10-29
## やったこと
- [[Vault]] の仕組みを調べた #学習/obsidian
- [[Markdown]] の記法をまとめた
## 次にやること
- [ ] .gitignore を書く #todo
コミュニティプラグイン(Dataviewなど)と安全性
この節では、コミュニティプラグインの入れ方、よく使われるプラグイン、ファイル上の置き場所、安全面で気をつけることが分かります。
公式の登録リスト(obsidian-releases の community-plugins.json)を数えると、2026年10月29日時点でプラグインは 9,660 本、テーマは 951 個でした。ダウンロード数の上位は次のとおりです(community-plugin-stats.json の値)。
| 順位 | プラグイン | ダウンロード数 | できること |
|---|---|---|---|
| 1 | Excalidraw | 8,784,570 | 手書き風の図を描く |
| 2 | Templater | 6,052,721 | スクリプトを使えるテンプレート |
| 3 | Dataview | 5,227,049 | プロパティを問い合わせて一覧にする |
| 4 | Tasks | 4,531,180 | 期限つきのタスク管理 |
| 5 | Git | 3,375,309 | 保管庫を Git で自動コミット・同期 |
入れ方(公式ヘルプの手順)
- 1制限モード(Restricted mode)を切る設定 → コミュニティプラグイン →「Turn on community plugins」。既定では使えない状態
- 2Browse で探して Install名前・作者・説明で検索できる。community.obsidian.md でも探せる
- 3Enable で有効にする入れた直後か、Installed plugins の一覧から
- 4更新は手動で確かめる安全のため自動更新されない。Check for updates → Update all
プラグインの実体はフォルダー1つ
Dataview の配布ファイル(0.5.68)を保管庫の .obsidian/plugins/dataview/ に置いた中身です。main.js がプラグインのコード、manifest.json が名前と版、data.json がプラグインの設定です。
$ ls -l .obsidian/plugins/dataview/
-rw-r--r-- 1 root root 3 data.json
-rw-r--r-- 1 root root 2377634 main.js
-rw-r--r-- 1 root root 357 manifest.json
-rw-r--r-- 1 root root 2965 styles.css
$ cat .obsidian/plugins/dataview/manifest.json (抜粋)
{
"id": "dataview",
"name": "Dataview",
"version": "0.5.68",
"minAppVersion": "0.13.11",
"description": "Complex data views for the data-obsessed.",
"isDesktopOnly": false
}
Dataview は、ノートの中に dataview のコードブロックで問い合わせを書くと、その結果を表や一覧で表示します。公式ドキュメントの例は次の形です(種類は LIST・TABLE・TASK・CALENDAR)。
```dataview
TABLE status, rating
FROM "notes"
SORT file.name ASC
```
この問い合わせが表に出す値は、記事用の保管庫なら Markdown(status は下書き・rating は空)と Vault(完了・4)で、上の Python でプロパティを読んだ結果と同じです。Dataview はファイルを書き換えず、表示のたびに保管庫を読んで集計します。Obsidian の外で開くと、コードブロックがそのまま見えるだけです。
安全面で気をつけること
公式ヘルプ(Plugin security)は、コミュニティプラグインは「パソコンのファイルにアクセスでき、インターネットに接続でき、ほかのプログラムを入れられる」と書いています。Obsidian はプラグインの版ごとに自動で脆弱性やマルウェアの検査を行い、結果を表示していますが、すべてを人が確かめているわけではなく、人による確認は人気のもの・注目のもの・通報されたものが対象です。
プラグインの入れ方
公式は、機密を扱う場合はプラグインを独自に監査してから使うよう勧めている
Obsidianの同期方法と料金(Sync・iCloud・Git)
この節では、パソコンとスマホで同じノートを使う方法の選び方と、有料サービスの料金が分かります。
料金(2026年10月29日時点・公式)
| 項目 | 料金(米ドル) | 内容 |
|---|---|---|
| Obsidian アプリ | 無料 | 個人・仕事・非営利のどれでも無料。登録不要 |
| Sync Standard | 月 $4(年払い)/月 $5(月払い) | 保管庫1つ・1GB・1ファイル 5MB まで・履歴1か月 |
| Sync Plus | 月 $8(年払い)/月 $10(月払い) | 保管庫10・10GB(100GB まで拡張可)・200MB まで・履歴12か月 |
| Publish | 月 $8(年払い)/月 $10(月払い) | ノートを Web サイトとして公開(サイトごと) |
| Commercial license | 1人 年 $50(任意) | 仕事での利用に必須ではない。開発を支える購入 |
| Catalyst | $25・$50・$100(買い切り・任意) | 先行版(ベータ)を早く使える。機能の差は無い |
Commercial license は、2025年2月20日の公式ブログで「任意」になりました。以前は一定の規模の組織で仕事に使うときに必要でしたが、今は誰でも仕事に無料で使えます。端末の数は Standard・Plus とも無制限です。
同期の方法の選び方
| 方法 | 対応(公式の記載) | 向く人 | 注意 |
|---|---|---|---|
| Obsidian Sync | Windows・Mac・Linux・iOS・Android | スマホを含めて手間なく使いたい | 有料。設定もまとめて同期できる |
| iCloud | Mac・iPhone・iPad | Apple の端末だけで使う | 保管庫は iCloud Drive の Obsidian フォルダーに置く。Windows の iCloud は重複・破損の恐れ |
| OneDrive | Windows・Mac | パソコンだけで使う | ファイル オンデマンドを使わない。iOS は公式に非対応 |
| Google Drive | Windows・Mac・Android | ― | 公式には同期の対象外 |
| Syncthing | Windows・Mac・Linux | クラウドを使わずに端末どうしで同期 | 1台は電源を入れておくとよい |
| Git | Windows・Mac・Linux | 履歴を残したい開発者 | 自動ではない。push・pull を自分で行う |
公式ヘルプは、同じ保管庫を複数の同期の方法で同時に同期しないよう書いています(例:Obsidian Sync と iCloud を同時に使う)。競合やファイルの破損の原因になります。また、クラウドの「容量を空けるためにファイルを端末から消す」機能が働くと、Obsidian がファイルを読めなくなるため、保管庫は常に端末に置いておく設定にします。
Gitで保管庫を管理する(.gitignore・コンフリクト・名前変更)
この節では、保管庫を Git で管理するときの .gitignore の例と、2台で同じノートを直したときのコンフリクト、Obsidian の外で名前を変えたときに起きることが、実行結果で分かります。
.gitignore の例
# 開いているタブ・ペインの配置(端末ごとに変わる)
.obsidian/workspace.json
.obsidian/workspace-mobile.json
# Obsidian の「ごみ箱」(設定で .trash を選んだ場合)
.trash/
# OS が作るファイル
.DS_Store
Thumbs.db
workspace.json は、開いているタブやサイドバーの状態が変わるたびに書き換わるため、コミットに入れると差分がいつも出ます。除外されているかは git check-ignore -v で確かめられます。
$ git check-ignore -v .obsidian/workspace.json .obsidian/app.json
.gitignore:2:.obsidian/workspace.json .obsidian/workspace.json
(app.json は除外されていないので何も出ない)
$ git add -A && git status --short (抜粋)
A .obsidian/app.json
A .obsidian/plugins/dataview/main.js
A notes/Vault.md
A "templates/\346\227\245\345\240\261.md"
最後の行は日本語のファイル名「日報.md」です。Git の既定では、日本語のファイル名が8進数で表示されます。git -c core.quotepath=false status とすると templates/日報.md と読める形になります。パターンの書き方は、関連記事「.gitignoreの書き方一覧 パターン早見表と効かないときの確認手順」で扱っています。
2台で同じ行を直すとコンフリクトになる(実測)
1つの保管庫を2つの場所(端末Aと端末B)に clone し、同じノートのプロパティ status を別々の値に直してから pull しました。
$ git pull --no-rebase origin main
From /srv/s4/r17/t118/remote
* branch main -> FETCH_HEAD
598ecad..a034773 main -> origin/main
Auto-merging notes/Vault.md
CONFLICT (content): Merge conflict in notes/Vault.md
Automatic merge failed; fix conflicts and then commit the result.
$ head -8 notes/Vault.md
---
tags: [用語]
<<<<<<< HEAD
status: 公開済み
=======
status: 見直し中
>>>>>>> a034773e5f0e4c9aad9fb55deeb2e0d689c9e2f6
rating: 4
コンフリクトの印(<<<<<<< など)がプロパティの中に入ると、YAML として読めなくなります。同じファイルを PyYAML で読むと、次のエラーになりました。この状態のままだと、そのノートのプロパティは正しく扱えません。
ScannerError: while scanning a simple key
in "<unicode string>", line 2, column 1:
<<<<<<< HEAD
^
could not find expected ':'
in "<unicode string>", line 3, column 1:
status: 公開済み
^
どちらの値を残すか決めて印を消し、コミットし直します。印の読み方と解き方は、関連記事「Gitのコンフリクトの解消方法|マーカーの読み方から防ぎ方まで」で扱っています。2台で使うなら、書き始める前に pull、書き終えたら commit と push、を習慣にするとコンフリクトが減ります。
Obsidian の外で名前を変えるとリンクが切れる(実測)
公式ヘルプによると、Obsidian の中でファイル名を変えると、そのノートへの内部リンクは自動で書き換わります(設定 → ファイルとリンク の「Automatically update internal links」)。一方、Git やエクスプローラーなど外で名前を変えると、リンクの文字は変わりません。
$ git mv notes/Markdown.md notes/Markdown記法.md
$ grep -rn '\[\[Markdown' --include=*.md .
./notes/Vault.md:8:保管庫はただのフォルダーです。詳しくは [[Markdown#見出しの例|見出しへのリンク]] を見ます。
./notes/Vault.md:10:![[Markdown#見出しの例]]
./daily/2026-10-29.md:9:- [[Markdown]] の記法をまとめた
$ python3 index.py . (抜粋)
2026-10-29 -> Markdown [未作成]
Vault -> Markdown#見出しの例 [未作成]
Vault -> Markdown#見出しの例 (埋め込み) [未作成]
名前の変更は Obsidian の中で行うのが確実です。外で変えてしまったら、元の名前に戻すか、grep で見つけたリンクを書き直します。
3,000 ノートでの実測
1ノート約 700 バイト・各5本のリンク付きのノートを 3,000 個作り、Git とスクリプトの速さを測りました(2 CPU のマシン)。テキストだけの保管庫なら、Git の操作は一瞬で終わります。
| 操作 | 結果 |
|---|---|
| ノートの合計(実際のバイト数) | 2.2MB(3,000 ファイル) |
| git add(全ファイル) | 0.134 秒 |
| git commit | 0.017 秒 |
| 圧縮後のリポジトリ(git gc 後) | pack 446KiB・.git 全体 880KB |
| 1ノートを直した後の git status | 0.007 秒 |
| リンク 15,000 本とバックリンクの集計(Python) | 0.777 秒 |
画像や PDF を多く入れると、Git のリポジトリは急に大きくなります。添付ファイルが多い保管庫は、Git では Markdown だけを管理し、添付は別の方法で同期する、という分け方もあります。
Notion・Logseq・Evernoteとの違い(判断表)
この節では、よく比べられるメモアプリとの違いと、目的ごとの選び方が分かります。
| Obsidian | Notion | Logseq | Evernote | |
|---|---|---|---|---|
| データの置き場所 | 手元のフォルダー(.md) | クラウド | 手元のファイル(Markdown・org)。DB 版はベータ | クラウド |
| 得意なこと | リンクでつなぐ個人のノート | データベース・共同編集 | 箇条書き(アウトライン)で書く日誌 | Web の切り抜き・メモの保存 |
| ソースコード | 非公開 | 非公開 | 公開(AGPL-3.0) | 非公開 |
| 料金の目安 | アプリ無料。Sync 月 $4〜 | Free・Plus $10・Business $20(1人・月) | 無料 | Free は 50 ノート・同期1台まで |
| チームでの同時編集 | 前提にしていない | 得意 | 前提にしていない | 共有は可能 |
料金は各社の公式ページの 2026年10月29日時点の表示です(Notion は1人・月あたりの米ドル。年払いで最大20%安くなる表示あり)。
Obsidian が向く
自分の知識・技術メモを長く育てたい
ファイルを手元に置き、Git やほかのエディタでも扱いたい
オフラインでも書きたい
ほかを選ぶ・併用する
チームで同時に編集する・タスクをデータベースで管理する → Notion
箇条書き中心で日誌を書きたい・オープンソースがよい → Logseq
個人のノートは Obsidian、共有は Notion と分ける使い方も多い
Notion や Evernote から移るときは、公式の Importer プラグインが使えます。対応している移行元は Notion・Evernote・Microsoft OneNote・Apple Notes・Google Keep・Bear・Roam Research・Logseq などです。Notion の使い方とデータベースの設計は、関連記事「Notionの使い方とNotion API|データベース設計とPython実例」で扱っています。
AI ツールと組み合わせる
保管庫はただのテキストなので、生成 AI のコーディングツールやエディタで保管庫のフォルダーを開けば、ノートの検索・要約・整理をそのまま頼めます。Obsidian の中から AI を使うプラグインもあります。社外秘のノートを外部の AI サービスに渡すかどうかは、会社のルールに合わせて決めます。
Obsidianのよくあるエラー・つまずき
この節では、Obsidian を使い始めてつまずきやすい点と、その原因・直し方が分かります。
| 症状・表示 | 原因 | 直し方 |
|---|---|---|
| ほかのツールで [[ノート名]] がリンクにならない | Wikiリンクは標準の Markdown ではない(marked・pandoc の既定で確認) | Use [[Wikilinks]] を切って Markdown 形式のリンクにする |
| プロパティが見出しや区切り線で表示される | front matter に対応しない変換ツール(marked で確認) | front matter を外して変換する・対応ツールを使う |
| 名前を変えたらリンクが切れた | Obsidian の外で名前を変えた | Obsidian の中で変える。外で変えたら元に戻す |
| ScannerError: while scanning a simple key | Git のコンフリクトの印がプロパティに入った | 印を消してどちらかの値を残す |
| "templates/\346\227\245…" と表示される | Git が日本語のファイル名を8進数で表示 | git -c core.quotepath=false で見る |
| #1984 がタグにならない | 数字だけのタグは無効 | #y1984 のように文字を含める |
| tag・alias が効かない | 単数形は 1.9 で既定の扱いが無くなった | tags・aliases・cssclasses に直す |
| コミュニティプラグインが入れられない | 制限モードがオン | Turn on community plugins で切る |
| 同期でファイルが重複・競合する | 複数の同期方法を同時に使っている・ファイルが端末から消されている | 同期方法を1つにし、常に端末に置く設定にする |
保管庫の置き場所
公式ヘルプは、同じ保管庫を複数のサービスで同期すると競合や破損の原因になるとしている
フォルダー分けに迷ったら、最初は「notes」「daily」「templates」「attachments」程度に分け、細かい分類はタグとリンクで行うと、後から並べ替えやすくなります。
よくある質問
Q. Obsidian とは何ですか? A. パソコンの中のフォルダー(保管庫)に Markdown のファイルとしてノートを保存し、[[ ]] のリンクでつないで管理するメモアプリです。バックリンクやグラフビューで、ノートのつながりが見えます。
Q. Obsidian は無料で使えますか? A. アプリは、個人・仕事・非営利のどれでも無料です(2025年2月20日から仕事での利用にもライセンスは不要)。有料なのは、同期の Obsidian Sync(月 $4〜)、公開の Publish(月 $8〜)、任意の支援ライセンスです(2026年10月29日時点)。
Q. Obsidian の読み方は? A. 「オブシディアン」です。英語で黒曜石という意味です。
Q. Obsidian は日本語で使えますか? A. 使えます。設定 → General → Language で日本語を選びます。配布物には日本語の言語ファイル(ja.txt)が入っています。ノートの中身は UTF-8 のテキストなので、日本語のファイル名・本文も扱えます。
Q. 保管庫(Vault)とは何ですか? A. ノートを入れるフォルダーです。中には .md のノート、画像などの添付、設定フォルダー .obsidian が入ります。複数の保管庫を作り、仕事用と個人用を分けることもできます。
Q. スマホと同期するには? A. いちばん手間が少ないのは有料の Obsidian Sync です。Apple の端末だけなら iCloud、パソコンだけなら OneDrive や Git も使えます。同じ保管庫を複数の方法で同時に同期しないようにします。
Q. Git で管理するときに除外するファイルは? A. 開いているタブの配置を保存する .obsidian/workspace.json と workspace-mobile.json が代表です。プラグインの data.json に API キーなどを保存するものがあれば、それも公開リポジトリには入れません。
Q. Obsidian をやめたらノートはどうなりますか? A. フォルダーの .md ファイルはそのまま残り、ほかのエディタで開けます。ただし [[ ]] のリンク・埋め込み・Dataview の問い合わせは、ほかのツールでは文字のまま表示されます。
Q. Notion と Obsidian はどちらがよいですか? A. 自分の知識を手元のファイルで育てるなら Obsidian、チームでデータベースや共同編集を使うなら Notion が向きます。個人のメモは Obsidian、共有する情報は Notion と分ける使い方もあります。
Q. コミュニティプラグインは安全ですか? A. プラグインは Obsidian と同じ権限で動き、ファイルの読み書きやネットワーク接続ができます。Obsidian は版ごとに自動検査をしていますが、機密のある保管庫では、入れるプラグインを絞るか、制限モードのままにします。
まとめ
- Obsidian は、手元のフォルダーの Markdown ファイルをリンクでつなぐメモアプリで、アプリは仕事でも無料(2026年10月29日時点の版は 1.14.5)。
- 保管庫はただのフォルダー。ノートは .md、設定は .obsidian の JSON で、バックリンクやグラフはファイルを読み込んで計算される。
- [[ ]]・#タグ・先頭の --- のプロパティはファイルの中の文字。外のツールではリンクにならないため、持ち出す予定なら Markdown 形式のリンクに切り替える。
- 同期は Obsidian Sync(月 $4〜)・iCloud・Git などから1つを選ぶ。Git なら workspace.json を除外し、コンフリクトと外での名前変更に注意する。
- コミュニティプラグインは 9,660 本あり便利だが、Obsidian と同じ権限で動くので、作者と更新状況を見て必要なものだけ入れる。
参考・出典
確認日はいずれも 2026年10月29日です。
- Obsidian「Download」:https://obsidian.md/download
- Obsidian「Pricing」:https://obsidian.md/pricing
- Obsidian「Sync」:https://obsidian.md/sync
- Obsidian「License」:https://obsidian.md/license
- Obsidian Blog「Obsidian is now free for work」(2025年2月20日):https://obsidian.md/blog/free-for-work/
- Obsidian Help「How Obsidian stores data」:https://obsidian.md/help/data-storage
- Obsidian Help「Configuration folder」:https://obsidian.md/help/configuration-folder
- Obsidian Help「Internal links」:https://obsidian.md/help/links
- Obsidian Help「Embed files」:https://obsidian.md/help/embeds
- Obsidian Help「Tags」:https://obsidian.md/help/tags
- Obsidian Help「Properties」:https://obsidian.md/help/properties
- Obsidian Help「Backlinks」:https://obsidian.md/help/plugins/backlinks
- Obsidian Help「Graph view」:https://obsidian.md/help/plugins/graph
- Obsidian Help「Search」:https://obsidian.md/help/plugins/search
- Obsidian Help「Bases」:https://obsidian.md/help/bases
- Obsidian Help「Daily notes」:https://obsidian.md/help/plugins/daily-notes
- Obsidian Help「Templates」:https://obsidian.md/help/plugins/templates
- Obsidian Help「Views and editing mode」:https://obsidian.md/help/edit-and-read
- Obsidian Help「Command palette」「Quick switcher」「Hotkeys」:https://obsidian.md/help/plugins/command-palette
- Obsidian Help「Settings」:https://obsidian.md/help/settings
- Obsidian Help「Obsidian CLI」:https://obsidian.md/help/cli
- Obsidian Help「Community plugins」:https://obsidian.md/help/community-plugins
- Obsidian Help「Plugin security」:https://obsidian.md/help/plugin-security
- Obsidian Help「Sync your notes across devices」:https://obsidian.md/help/sync-notes
- Obsidian Help「Sync plans and storage」:https://obsidian.md/help/sync/plans
- Obsidian Help「Catalyst license」:https://obsidian.md/help/catalyst
- Obsidian Help「Import notes」:https://obsidian.md/help/import
- obsidian-releases(コミュニティプラグイン・テーマの登録リストと統計):https://github.com/obsidianmd/obsidian-releases
- Dataview「Structure of a Query」:https://blacksmithgu.github.io/obsidian-dataview/queries/structure/
- Logseq(GitHub):https://github.com/logseq/logseq
- Notion「料金プラン」:https://www.notion.com/ja/pricing
- Evernote「Compare plans」:https://evernote.com/compare-plans
本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。
(記載例)出典:株式会社RJC「Obsidianとは?使い方と保管庫の中身・同期・Git管理を実物で解説」
株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。
WE ARE HIRING
RJCで一緒に開発しながら、
成長を楽しみませんか?
RJCは、Web・モバイル・AIを活用した開発プロジェクトで、テックリードやPM・PMOも活躍するシステム開発会社です。会社を知る、待遇を確かめる、話を聞いてみる。気になるところ見てみてください!
- 127日年間休日
- 12時間平均残業時間
- 毎日ガチャ遊びココロも大切にする福利厚生。アマギフなどの賞品ラインナップ!
ほかにも、チケットレストラン、書籍読み放題、2年ごとの慰労報奨(休暇 or 金一封)、11期連続の黒字決算。