위키링크 (Wikilink)
위키링크(wikilink) 는 위키 시스템에서 다른 문서로 이동하는 내부 링크 표기법입니다.
대괄호 두 개로 감싸는 [[...]] 형태가 특징이며, 일반 마크다운 링크 [텍스트](URL) 와는
구분됩니다.
달리위키는 Obsidian 으로 편집되며, 빌드 시점에
remark-wiki-link 플러그인이 [[...]] 표기를 실제 HTML 링크로 변환합니다.
기본 문법
섹션 제목: “기본 문법”[[경로]][[경로|표시할 텍스트]]세로 막대(|) 뒤에 별칭을 적으면 표시 텍스트가 바뀝니다. 별칭이 없으면
대상 문서의 제목이 자동으로 표시됩니다 (아래 “제목 자동 치환” 참고).
실제 예시:
[[term/peba]]→ PEBA (Polyether Block Amide)[[term/peba|페바]]→ 페바[[term/없는-문서]]→ term/없는-문서
경로는 카테고리/파일명 형식이며, 확장자 .md 는 생략합니다.
대상 문서가 없으면 빨간 글씨에 (없음) 꼬리표가 붙습니다.
경로 변환 규칙
섹션 제목: “경로 변환 규칙”[[...]] 안의 경로는 다음 규칙으로 정규화됩니다:
- 소문자화: 영문 대문자는 모두 소문자로 변환
- 공백 → 하이픈: 공백 문자는
-로 치환 - 한글은 그대로 통과 (대소문자 개념 없음)
예를 들어 [[Term/VDOT]], [[term/vdot]], [[term/VDOT]] 는 모두 같은
/term/vdot 으로 연결됩니다.
제목 자동 치환
섹션 제목: “제목 자동 치환”별칭(|) 을 적지 않은 위키링크는 대상 문서 프론트매터의 title 값으로
표시 텍스트가 자동 치환됩니다.
예시: PEBA (Polyether Block Amide) 라고 적으면 실제로는 대상 문서의 title 인 “PEBA (Polyether Block Amide)” 로 표시됩니다.
이 동작 덕분에 대상 문서의 제목이 바뀌어도 각 위키링크를 일일이 수정할
필요가 없습니다. 다른 표현이 필요할 때만 [[term/peba|페바]] 처럼
별칭을 지정합니다.
깨진 링크 표시
섹션 제목: “깨진 링크 표시”대상 문서가 존재하지 않는 위키링크는 빨간색 점선 밑줄과 함께 (없음)
꼬리표로 표시됩니다:
[[term/아직-없는-용어]]일반 마크다운 링크와의 차이
섹션 제목: “일반 마크다운 링크와의 차이”| 항목 | 위키링크 | 마크다운 링크 |
|---|---|---|
| 문법 | [[term/peba]] | [페바](/term/peba) |
| 대상 | 같은 위키 내부 문서 | 내부·외부 모두 |
| 경로 검증 | 빌드 시 존재 여부 확인 | 검증 없음 |
| 표시 텍스트 | 생략 가능 (자동 제목) | 항상 명시 |
| 외부 링크 | 불가 | 가능 |