# 문서 링크 (/style/document-link)





**에디터 지원 환경:** [에피소드](/episode) (미지원), [위키](/wiki) (지원), [메모](/memo) (미지원), [캔버스](/canvas) (미지원)

**이런 경우에 사용해보세요**

* 인물이나 설정을 언급한 문구가 항상 같은 위키 문서로 연결되게 하고 싶나요?
* 다이나믹 링크의 자동 감지 결과를 문서 데이터에 고정하고 싶나요?

**이럴 때는 다른 기능이 더 잘 맞아요**

- 외부 웹사이트 주소를 문구에 연결할 때 → [하이퍼링크](/style/hyperlink)
- 문서명을 자동으로 감지하되 본문 데이터는 바꾸고 싶지 않을 때 → [다이나믹 링크](/editor-functions/dynamic-link)

문서 링크는 문구에 같은 작품 안의 다른 [위키 문서](/wiki)를 연결하는 서식입니다. 링크의 대상이 본문 데이터에 저장되므로 [다이나믹 링크](/editor-functions/dynamic-link)를 꺼도 유지되며, 연결 대상의 정보를 확인하거나 해당 문서로 이동할 수 있습니다.

## 입력 방법 [#입력-방법]

### `@`로 입력하기 [#로-입력하기]

본문에서 `@` 뒤에 문서명이나 별칭을 입력하면 연결할 수 있는 위키 문서가 표시됩니다. 원하는 문서를 선택하면 입력한 부분이 문서 링크로 바뀝니다.

### 다이나믹 링크 고정하기 [#다이나믹-링크-고정하기]

[다이나믹 링크](/editor-functions/dynamic-link)가 감지한 문구를 `Alt + 클릭`하면 같은 대상을 가리키는 문서 링크로 고정할 수 있습니다.

### 한꺼번에 생성하기 [#한꺼번에-생성하기]

현재 문서에서 감지할 수 있는 링크를 한꺼번에 고정하려면 위키 에디터 메뉴의 <TbLink style="{ display: 'inline' }" /> `자동 일괄 링크 생성`을 사용하세요. 이미 고정되었거나 일반 [하이퍼링크](/style/hyperlink)가 적용된 문구는 중복 변환하지 않습니다.

## 링크 미리보기와 이동 [#링크-미리보기와-이동]

데스크톱에서 문서 링크에 마우스를 올리면 연결된 위키 문서의 미리보기 카드가 열립니다. 다이나믹 링크의 미리보기와 같은 구조이며 다음 정보를 표시합니다.

* 현재 문서 제목과 분류
* 문서에 등록된 썸네일
* 최대 120자까지 표시되는 문서 요약
* 문서 속성표에서 앞쪽에 등록된 속성 최대 7개

썸네일·요약·속성이 등록되지 않았다면 해당 영역은 표시하지 않습니다. 상세 정보를 불러오는 동안에는 로딩 표시가 나타나며, 대상 문서가 삭제되었다면 `삭제된 문서입니다.`, 그 밖의 이유로 불러오지 못했다면 `문서를 불러오지 못했어요.`라고 안내합니다. 삭제된 문서도 링크에 저장된 제목은 카드 상단에 남을 수 있습니다.

문서 링크를 누르면 연결된 [위키 문서](/wiki)로 이동합니다. `Ctrl + 클릭`, macOS의 `Command + 클릭` 또는 휠 클릭을 사용하면 현재 작업 화면을 유지한 채 새 탭이나 새 탐색 맥락으로 엽니다. [워크스페이스](/workspace)에서는 일반 클릭 시 열려 있는 위키 탭을 사용하고, 보조 클릭 조작을 사용하면 새 위키 탭을 만듭니다.

## 다이나믹 링크와의 차이 [#다이나믹-링크와의-차이]

| 구분     | 문서 링크                   | 다이나믹 링크                     |
| ------ | ----------------------- | --------------------------- |
| 저장 방식  | 링크 대상이 본문 데이터에 저장됩니다.   | 본문은 바꾸지 않고 화면에서 자동으로 감지합니다. |
| 표시 조건  | 다이나믹 링크 설정과 관계없이 유지됩니다. | 기능을 활성화한 동안만 표시됩니다.         |
| 적합한 상황 | 특정 문구의 연결 대상을 확정할 때     | 여러 문서명을 별도 편집 없이 빠르게 탐색할 때  |

## 외부 호환성 [#외부-호환성]

| 형식        | 호환성      | 변환 결과           | 설명                                                           |
| --------- | -------- | --------------- | ------------------------------------------------------------ |
| HTML      | ⚠️ 일부 호환 | `<a>문구</a>`     | 문구와 뮤블 내부 연결 정보는 포함되지만, 외부 웹주소로 이동하는 링크는 만들어지지 않습니다.         |
| Markdown  | ⚠️ 일부 호환 | `[문구](문서 제목)`   | 저장된 문서 제목을 링크 대상으로 사용합니다. 뮤블 프로젝트 내부 문서로 연결되는 기능은 유지되지 않습니다. |
| DOCX      | ❌ 미지원    | 밑줄이 적용된 `문구`    | 문구와 밑줄은 남지만 뮤블 내부 문서 연결은 유지되지 않습니다.                          |
| MediaWiki | ✅ 호환     | `[[문서 제목]]`     | 연결된 문서의 저장된 제목을 내부 링크 문법으로 내보냅니다.                            |
| 나무위키      | ✅ 호환     | `[[문서 제목\|문구]]` | 저장된 문서 제목과 표시 문구를 내부 링크 문법으로 내보냅니다. 두 값이 같으면 표시 문구는 생략됩니다.   |

> **제작자의 말**
>
> [#제작자의-말]
> 
> 문서 링크로 원고와 설정 문서를 촘촘하게 연결하면 겉으로는 이상적인 구조처럼 보입니다. 하지만 에피소드 본문까지 문서 링크를 지원하면, 집필 중에도 어떤 표현을 어느 문서에 연결할지 계속 판단해야 해요. 링크 대상이 바뀌거나 사라졌을 때 관리해야 할 데이터와 화면도 함께 늘어납니다.
> 
> 요즘 새로 등장하는 집필 앱 중에는 [Obsidian](https://obsidian.md)이나 [Notion](https://www.notion.com)에서 영감을 받아 백링크와 문서 연결 관계를 핵심 기능으로 가져오는 경우가 많습니다. 지식과 자료를 자유롭게 쌓고 다시 탐색하는 도구에서는 강력한 방식입니다. 하지만 시간 순서대로 원고를 쓰고, 회차를 고치며, 하나의 작품을 완성해 가는 집필 워크플로에서도 언제나 같은 이득을 주는 것은 아닙니다.
> 
> 원고에 연결 관계가 많아질수록 작가는 글뿐 아니라 링크의 생성·수정·누락까지 관리하게 됩니다. 지식 관리 도구에서 유용한 개념을 그대로 가져오는 것이 곧 작품 관리에도 좋은 설계라고 보지는 않았습니다. 뮤블은 연결이 실제 집필과 설정 탐색에 주는 이득이 관리 부담보다 분명히 클 때만 문서 구조에 포함하려고 합니다.
> 
> 원고에서 얻는 탐색상의 이점보다 문서 데이터의 복잡성, 집필 중 추가되는 작업, 관리해야 할 범위가 더 커진다고 판단했습니다. 그래서 문서 링크는 설정을 정리하고 탐색하는 [위키](/wiki)에만 제공하고, [에피소드](/episode)에서는 본문 데이터를 바꾸지 않는 [다이나믹 링크](/editor-functions/dynamic-link)로 필요한 연결을 보여줍니다. 만들 수 있는 기능이라도 작가가 관리해야 할 일을 더 많이 만든다면 과감히 빼는 것이 낫다고 생각했습니다.

***

- **사용 가능 버전:** v2.11.0 ↑
- **문서 최종 갱신 버전:** v2.11.5