본문 바로가기
스터디 열기

링크로 잇고 백링크로 확인하기

1. 링크로 잇고 백링크로 확인하기

문서가 서로 이어지지 않으면 위키가 아니라 폴더입니다. 이 절에서 링크를 다룹니다.

1.1 링크가 하는 일

[[free-trial]]처럼 대괄호 두 개로 감싸면 다른 문서를 가리키는 링크가 됩니다. Obsidian은 이것을 위키링크(Wikilink)라고 부릅니다. 이 표기가 하는 일은 셋입니다.

  • 사람이 따라갈 수 있습니다: Obsidian에서 눌러서 그 문서로 이동합니다.
  • AI가 관련 문서를 찾습니다: 질문에 답할 때 문서 하나를 읽다가 링크를 보고 그쪽도 열어 봅니다. 링크가 없으면 색인에만 기대게 됩니다.
  • 연결의 모양이 보입니다: 다음 절의 그래프 뷰가 이 링크를 그림으로 그립니다.

몇 가지 변형도 알아 두면 좋습니다.

표기뜻
[[competitor-a]]문서 전체로 가는 링크
[[competitor-a#요금 구조]]그 문서의 '요금 구조' 소제목으로 가는 링크
[[competitor-a|A사]]링크는 그대로, 화면에는 'A사'로 보이게

소제목 링크는 이 장의 마지막 절에서 문서를 쪼갤지 판단할 때 다시 씁니다. 세 번째 표기를 위키 문서의 표 안에 넣을 때는 [[competitor-a\|A사]]처럼 | 앞에 \를 붙여야 표가 깨지지 않습니다. |가 표의 칸 나눔과 같은 글자이기 때문입니다.

1.2 어디에 거는가

링크는 두 자리에 겁니다.

본문 안에는 그 문서를 언급하는 자리에 그대로 겁니다.

경쟁사 A의 무료 체험은 14일입니다. 다른 회사와의 비교는
[[pricing-comparison]]에 정리돼 있습니다.

맨 아래 관련 문서 절에는 설명을 붙여 모아 둡니다.

## 관련 문서
- [[free-trial]] 무료 체험 정책의 설계
- [[pricing-comparison]] 경쟁사 요금제 비교표
- [[decision-trial-7days]] 이 정보를 근거로 내린 결정

설명을 붙이는 것이 중요합니다. 링크만 나열하면 왜 관련 있는지 알 수 없습니다.

1.3 양쪽에 거는 규칙

competitor-a.md에서 [[free-trial]]을 걸었다면, free-trial.md에서도 [[competitor-a]]를 겁니다.

이유는 백링크가 어디에 있느냐에 있습니다. 백링크(이 문서를 가리키는 다른 문서 목록)는 파일에 적혀 있지 않습니다. Obsidian이 보관함 전체를 훑어 계산해서 화면에 보여 주는 값입니다. 그래서 폴더의 파일만 열어 읽는 AI는 free-trial.md 안에 [[competitor-a]]가 적혀 있어야 두 문서가 관련 있다는 것을 압니다.

예외는 있습니다. 4장 끝에서 본 Obsidian CLI를 쓰면, Claude Code처럼 내 컴퓨터에서 명령을 실행하는 AI는 Obsidian이 계산한 백링크를 꺼내 볼 수 있습니다. 명령은 이 절 1.5에서 씁니다.

그래도 이 책은 양쪽에 거는 규칙을 기본으로 둡니다.

  • CLI는 내 컴퓨터에서 Obsidian 앱이 돌고 있어야 동작하고, 그 컴퓨터에서 명령을 실행할 수 있는 AI만 씁니다. 같은 위키를 어느 도구로 여느냐에 따라 되기도 하고 안 되기도 합니다.
  • 링크가 파일 안에 적혀 있으면 어떤 AI가 읽든, Obsidian 없이 열든 관계가 보입니다. 위키를 평문 파일로 두는 이유와 같습니다.

규칙 문서에 넣습니다.

문서 A가 문서 B를 링크하면, 문서 B의 '관련 문서'에도 A를 넣습니다.
한쪽만 걸린 링크는 린트에서 잡습니다.

1.4 백링크로 확인하기

양쪽에 걸었는지는 Obsidian의 백링크 패널로 확인합니다. 4장에서 오른쪽 사이드바에 띄워 뒀습니다. 보이지 않으면 명령 팔레트(Ctrl+P, macOS는 Cmd+P)에서 Backlinks: Show backlinks를 실행합니다.

패널은 두 부분입니다.

부분보여 주는 것
연결된 언급(Linked mentions)이 문서를 링크로 가리키는 문서들
연결되지 않은 언급(Unlinked mentions)이 문서의 이름이 본문에 나오는데 링크로는 안 걸린 자리

여기서 보는 것은 셋입니다.

  • 연결된 언급에는 있는데 관련 문서 절에는 없는 것: 한쪽만 걸린 링크입니다. 그 문서를 관련 문서에 더합니다.
  • 연결된 언급이 하나도 없는 것: 이 문서는 위키에서 떨어져 있습니다. 색인에만 걸려 있으면 질문할 때 잘 안 걸립니다.
  • 연결된 언급이 유난히 많은 것: 이 문서가 허브가 됐다는 뜻입니다. 나쁜 것은 아니지만 문서가 너무 커졌는지 볼 신호입니다.

연결되지 않은 언급에서는 링크로 만들 자리를 고를 수 있습니다.

competitor-a 문서의 Backlinks 패널입니다. Linked mentions에는 링크로 가리키는 문서 다섯 곳이, Unlinked mentions에는 log.md처럼 이름만 글자로 적힌 자리가 따로 모여 있습니다.

백링크를 문서 맨 아래에 붙여 보는 방법도 있습니다. 백링크 플러그인 옵션의 Backlink in document를 켜면, 문서를 읽다가 끝까지 내려왔을 때 이 문서를 가리키는 목록이 바로 보입니다. 1.12부터는 캔버스(Canvas) 파일에서 건 링크도 백링크에 잡힙니다.

1.5 링크를 한 번에 점검하기

문서가 스무 장을 넘으면 백링크를 하나씩 보기 번거롭습니다. AI에게 한 번에 시킵니다.

wiki/ 전체에서 링크 상태를 점검해줘.

1. 한쪽에서만 걸린 링크: A가 B를 링크하는데 B는 A를 안 가리키는 경우.
2. 끊긴 링크: [[문서명]]으로 걸려 있는데 실제 파일이 없는 경우.
3. 고아 문서: 아무 데서도 링크되지 않은 문서. index.md는 빼고 세줘.

각각 목록으로 보여주고, 고칠 방법을 제안해줘.
아직 고치지는 마.

세 번째 항목에서 index.md를 빼라고 한 이유가 있습니다. 색인은 모든 문서를 링크하므로, 색인을 세면 고아 문서가 하나도 없는 것으로 나옵니다.

AI는 이 점검을 파일을 하나씩 열어 링크를 세는 방식으로 합니다. Claude Code처럼 명령을 실행하는 도구를 쓰고 Obsidian CLI를 켜 뒀다면(Settings → General → Command line interface), Obsidian이 이미 계산한 값을 받아 대조하게 할 수도 있습니다.

명령공식 설명
obsidian backlinks한 파일로 들어오는 백링크 목록
obsidian links한 파일에서 나가는 링크 목록
obsidian unresolved보관함 안의 끊긴(아직 없는 문서를 가리키는) 링크
obsidian orphans들어오는 링크가 없는 파일

obsidian orphans를 그대로 믿으면 안 되는 자리가 하나 있습니다. 이 명령은 색인에서 오는 링크도 들어오는 링크로 셉니다. 그래서 색인에 올라간 문서는 고아로 나오지 않고, 색인에서도 빠진 문서만 나옵니다. 위 요청문 3번처럼 색인을 빼고 세려면 AI에게 문서마다 obsidian backlinks로 받은 목록에서 index.md를 빼고 세게 합니다.

어느 쪽이든 결과를 보고 무엇을 고칠지는 사람이 정합니다. 이 점검은 10장에서 스킬로 고정합니다.

1.6 없는 문서를 미리 링크하기

[[]] 표기는 아직 없는 문서도 가리킬 수 있습니다. Obsidian에서는 이런 링크가 다른 링크와 구별되게 보이고, 누르면 그 이름으로 새 문서가 만들어집니다. 실수로 눌러 빈 문서가 생기면 지우면 됩니다.

이 성질을 할 일 목록으로 씁니다.

[추론] 이 회사의 기업 교육 사업은 별도로 정리할 만합니다.
[[competitor-a-enterprise]] 문서가 필요해 보입니다.

이렇게 걸어 두면 두 가지가 됩니다. 나중에 자료가 들어왔을 때 AI가 이 링크를 보고 그 문서를 만들고, 그때까지는 그래프 뷰에 아직 없는 문서로 나타나 안 채운 자리가 보입니다.

한 번에 확인할 수도 있습니다.

wiki/ 안에서 [[문서명]]으로 링크됐지만 실제 파일이 없는 것을 전부 찾아줘.
각각에 대해 그 문서를 만들 만한 자료가 raw/에 있는지도 확인해줘.

자료가 있으면 만들면 되고, 없으면 무엇을 더 구해야 하는지 알게 됩니다. 위키가 스스로 "여기가 빈다"고 알려 주는 셈입니다.

다음 절에서 이 연결을 그림으로 봅니다.

마지막 수정