콘텐츠로 이동

위키링크 (Wikilink)

위키링크(wikilink) 는 위키 시스템에서 다른 문서로 이동하는 내부 링크 표기법입니다. 대괄호 두 개로 감싸는 [[...]] 형태가 특징이며, 일반 마크다운 링크 [텍스트](URL) 와는 구분됩니다.

달리위키는 Obsidian 으로 편집되며, 빌드 시점에 remark-wiki-link 플러그인이 [[...]] 표기를 실제 HTML 링크로 변환합니다.

[[경로]]
[[경로|표시할 텍스트]]

세로 막대(|) 뒤에 별칭을 적으면 표시 텍스트가 바뀝니다. 별칭이 없으면 대상 문서의 제목이 자동으로 표시됩니다 (아래 “제목 자동 치환” 참고).

실제 예시:

경로는 카테고리/파일명 형식이며, 확장자 .md 는 생략합니다. 대상 문서가 없으면 빨간 글씨에 (없음) 꼬리표가 붙습니다.

[[...]] 안의 경로는 다음 규칙으로 정규화됩니다:

  • 소문자화: 영문 대문자는 모두 소문자로 변환
  • 공백 → 하이픈: 공백 문자는 - 로 치환
  • 한글은 그대로 통과 (대소문자 개념 없음)

예를 들어 [[Term/VDOT]], [[term/vdot]], [[term/VDOT]] 는 모두 같은 /term/vdot 으로 연결됩니다.

별칭(|) 을 적지 않은 위키링크는 대상 문서 프론트매터의 title 값으로 표시 텍스트가 자동 치환됩니다.

예시: PEBA (Polyether Block Amide) 라고 적으면 실제로는 대상 문서의 title 인 “PEBA (Polyether Block Amide)” 로 표시됩니다.

이 동작 덕분에 대상 문서의 제목이 바뀌어도 각 위키링크를 일일이 수정할 필요가 없습니다. 다른 표현이 필요할 때만 [[term/peba|페바]] 처럼 별칭을 지정합니다.

대상 문서가 존재하지 않는 위키링크는 빨간색 점선 밑줄과 함께 (없음) 꼬리표로 표시됩니다:

[[term/아직-없는-용어]]

term/아직-없는-용어

항목위키링크마크다운 링크
문법[[term/peba]][페바](/term/peba)
대상같은 위키 내부 문서내부·외부 모두
경로 검증빌드 시 존재 여부 확인검증 없음
표시 텍스트생략 가능 (자동 제목)항상 명시
외부 링크불가가능