개요

**위키링크(Wikilinks)**는 이중 대괄호(\[\[문서명\]\] 또는 \[\[문서명|별칭\]\])를 사용하여 텍스트 문서 간의 상호 연결을 형성하는 마크다운 확장 문법입니다. 개인 지식 관리(PKM), 세컨드 브레인(Second Brain), 디지털 가든(Digital Garden), 복리적 지식 베이스(LLM Wiki)의 핵심 연결 인프라로 활용됩니다.

주요 특징

  • 양방향 링크(Backlinks) 형성: 한 문서가 다른 문서를 참조하면 역방향 링크가 자동으로 감지되어 지식 그래프(Knowledge Graph)가 형성됩니다.
  • 단순성과 가독성: 긴 URL이나 복잡한 상대 경로 대신 문서 식별자(Slug/Title)만으로 직관적인 참조가 가능합니다.
  • 별칭(Alias) 지원: \[\[대상문서|표시텍스트\]\] 구문을 통해 문맥에 맞는 자연스러운 문장 흐름을 유지할 수 있습니다.

주의사항 및 서식 규칙

  1. 마크다운 표(Table) 내부 별칭 사용 금지:
    • 마크다운 표 내부에서 파이프(|)가 포함된 별칭을 사용할 경우 표의 열(Column) 구분이 깨질 수 있습니다.
    • 표 내부에서는 파이프 없는 단일 위키링크 또는 상대경로 표준 마크다운 링크(\[표시명\](경로.md))를 사용해야 합니다.
  2. 무결성 검증:
    • 존재하지 않는 문서를 가리키는 깨진 위키링크(Dead links)를 정기적으로 린트 도구(npm run lint:wiki)를 통해 점검하고 수정해야 합니다.

관련 문서