7.9 KB · updated 2026-05-19 · md

obsidian.ko.md

docs/i18n/integrations/obsidian.ko.md

Obsidian — 컴파일된 위키를 실제 vault로 열기

<!-- translations:start -->

English · 中文 · 日本語 · Русский · Español · Français · Deutsch

<!-- translations:end -->

Tesserae의 Obsidian export는 컴파일된 타입 그래프를 실질적이고 의견이 반영된 Obsidian vault로 변환합니다. 단순한 markdown 디렉터리가 아니라 .obsidian/ 설정, 타입을 인식하는 callouts, Dataview로 쿼리 가능한 frontmatter, vault 대시보드, 그리고 vault 간 wiki:// 참조 인덱스를 갖춘 진짜 vault입니다.

사전 요구사항

먼저 프로젝트를 컴파일하세요:

cd /path/to/your-project
tesserae project setup
tesserae project compile

컴파일은 진실의 원천인 .tesserae/graph.json과 .tesserae/markdown_projection/에 위치한 단순 markdown 투영을 생성합니다. Obsidian export는 이 투영 위에 구축되지만 모든 페이지에 Obsidian 네이티브 보강을 덧붙입니다.

1) vault export

tesserae project export-obsidian --vault ~/Documents/tesserae-vault

디렉터리가 없으면 생성됩니다. 다시 실행해도 멱등적으로 덮어씁니다 — 동일한 그래프가 주어지면 markdown 투영은 결정론적입니다.

디스크에 생성되는 것:

tesserae-vault/
  .obsidian/                  # Obsidian config (app.json, graph.json, plugins)
  README.md                   # Vault entry point
  index.md                    # All nodes grouped by section
  _bridges.md                 # Cross-vault wiki:// references, grouped by alias
  _meta/
    dashboard.md              # Dataview overview tables
  papers/                     # Paper / Repository / SourceDocument pages
  concepts/                   # Concept / Topic / Field / Method / Algorithm pages
  claims/                     # Claim / OpenQuestion / Evidence pages
  raw/                        # Optional raw-source attachments (created lazily)

2) Obsidian에서 디렉터리 열기

File → Open vault... → Open folder as vault → ~/Documents/tesserae-vault.

Obsidian이 .obsidian/를 감지하여 실제 vault로 인식하고 로드합니다. 커뮤니티 플러그인 목록에는 Dataview가 포함되어 있으므로, Obsidian이 활성화를 권유합니다(권장 — 활성화하지 않으면 dataview 블록이 코드 펜스로 렌더링됩니다).

Settings → Community plugins → Browse → "Dataview" → Install → Enable.

3) vault 둘러보기

진입점

  • README.md — 이 vault가 무엇이며 어떻게 새로고침하는지
  • index.md — 섹션별(papers, concepts, claims) 모든 노드를 wikilink와 함께 정리
  • _meta/dashboard.md — dataview 개요: 최근 페이지, papers, concepts/claims

페이지별 보강

이제 모든 노드 페이지는 다음을 함께 제공합니다:

타입 인식 callouts. 각 페이지 상단의 의미론적 callout이 노드 타입을 한눈에 보여줍니다:

> [!quote] Paper
> The paper triggered a wave of follow-on work: SuGaR aligns Gaussians...

> [!warning] Limitation
> No current method can achieve real-time display rates at 1080p...

> [!question] Open question
> How does dynamic-scene reconstruction scale...

매핑(주요 항목): Paper → quote, Repository → info, Contribution → success, Performance → info, Limitation → warning, Causal → important, OpenQuestion → question, Evidence → example.

Dataview로 쿼리 가능한 엣지. 이제 frontmatter는 타입이 부여된 엣지를 중첩 맵으로 담습니다:

edges_out:
  uses: [gaussian-splatting, volumetric-rendering]
  part_of: [3d-4d-vision-and-reconstruction]
  supports_claim: [performance-claim-..., comparison-...]
edges_in:
  mentioned_in: [project-pulse, topic-visual-slam]

다음과 같은 쿼리를 작성할 수 있습니다:

````markdown

LIST FROM "papers" WHERE contains(edges_out.uses, "nerf")
TABLE edges_out.supports_claim AS "Claims"
FROM "papers"
WHERE length(edges_out.supports_claim) > 3
SORT length(edges_out.supports_claim) DESC
LIMIT 10

````

vault 간 브리지. 노드의 설명이나 메타데이터에 언급된 모든 wiki://<alias>/<kind>/<slug> URI는 frontmatter 필드로:

cross_vault: [wiki://research/concepts/rlhf, wiki://notes/papers/arxiv-2510-12323]

그리고 Cross-vault references 본문 섹션으로 함께 노출됩니다. vault 단위 _bridges.md 인덱스는 대상 alias별로 묶인 모든 외부 참조를 집계하므로, 단일 페이지에서 vault 간 링크를 감사할 수 있습니다.

Related (dataview) 블록. 모든 페이지는 역참조하는 페이지를 자동으로 채워 보여주는 쿼리로 끝납니다:

````markdown

LIST
FROM "papers" OR "concepts" OR "claims"
WHERE contains(file.outlinks, this.file.link) AND file.name != this.file.name
SORT file.name
LIMIT 25

````

vault 대시보드

_meta/dashboard.md는 가장 유용한 집계 뷰를 위한 dataview 블록을 함께 제공합니다: 최근 업데이트된 페이지, 메타데이터 컬럼이 포함된 모든 papers, 타입별로 정렬된 모든 concepts와 claims. 자유롭게 편집하세요 — 고정된 계약이 아니라 출발점입니다.

vault 그래프 뷰

Obsidian 기본 그래프 뷰(Ctrl/Cmd+G)는 ## Outgoing / ## Incoming 섹션에 방출된 wikilink에 대해 이미 작동합니다. 함께 제공되는 .obsidian/graph.json은 방향성을 위해 papers/, concepts/, claims/ 경로를 색상으로 구분합니다. 더 풍부한 슬라이스를 위해 dataview로 필터링된 뷰를 그 위에 겹쳐 쌓을 수 있습니다.

vault 간 워크플로

여러 Tesserae vault를 등록하여 wiki:// URI가 그들 사이에서 해결되도록 만드세요:

tesserae register-project /path/to/research --name research
tesserae register-project /path/to/notes    --name notes

등록 후 각 vault를 다시 export하세요. 각 export의 _bridges.md는 이제 alias별로 묶여 vault 간에 해결 가능한 참조를 보여줍니다.

Obsidian 자체는 wiki:// URI를 네이티브로 따라가지 않으므로 인라인 텍스트로 렌더링됩니다 — 하지만 _bridges.md와 페이지별 Cross-vault references 섹션이 전용 Obsidian 플러그인이 등장할 때까지 수동 인덱스를 제공합니다.

새로고침 워크플로

Obsidian vault는 타입 그래프의 읽기 전용 export입니다. Obsidian에서의 편집은 .tesserae/graph.json으로 되돌아 흐르지 않습니다. 새 소스나 수정을 반영하려면:

# Edit source files under your project's source dirs (NOT the vault), then:
tesserae project compile
tesserae project export-obsidian --vault ~/Documents/tesserae-vault

Obsidian은 디스크에서 변경된 파일을 핫 리로드합니다. vault 내부에 그래프에서 투영되지 않은 markdown 노트(예: 본인의 개인 주석)를 추가했다면, 그것들은 살아남습니다 — export는 자신이 소유한 파일, 즉 papers/, concepts/, claims/ 아래의 파일과 index.md, _bridges.md, _meta/dashboard.md, README.md만 덮어씁니다.

정적 사이트와 비교해 언제 사용하나

컴파일된 HTML 사이트(tesserae project build-site → .tesserae/site/)는 공유용입니다 — GitHub Pages, S3, 모든 정적 호스트에 푸시할 수 있습니다. Obsidian vault는 Dataview와 Obsidian 그래프 뷰로 로컬에서 읽고 쿼리하기 위한 것입니다. 둘 다 동일한 그래프에서 투영되므로 결코 어긋나지 않습니다.