# 루비 (/style/ruby)





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

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

* 인물이나 지명의 한자·외국어 표기 위에 읽는 법을 함께 보여 주고 싶나요?
* 창작 용어의 원문과 독자가 읽을 발음을 한곳에 표시하고 싶나요?

루비는 원문 위에 발음이나 보조 표기를 작게 표시하는 서식입니다. 일본어 후리가나뿐 아니라 한자 독음과 창작 언어의 발음처럼 두 표기를 함께 보여 줄 때 사용할 수 있습니다.

## 표시 예시 [#표시-예시]

빠른 입력 방식에서는 `{원문|루비}`처럼 왼쪽에 본문에 남길 원문을, 오른쪽에 위쪽에 표시할 루비를 적습니다. 변환이 끝나면 중괄호와 구분선은 사라지고 다음처럼 표시됩니다.

| 용도        | 빠른 입력                | 표시 결과                                |
| --------- | -------------------- | ------------------------------------ |
| 일본어 후리가나  | `{東京\|とうきょう}`        | <ruby>東京<rt>とうきょう</rt></ruby>        |
| 한자 독음     | `{月下\|월하}`           | <ruby>月下<rt>월하</rt></ruby>           |
| 영문 이름의 발음 | `{Epin\|에핀}`         | <ruby>Epin<rt>에핀</rt></ruby>         |
| 창작 용어의 발음 | `{Aetherion\|에테리온}`  | <ruby>Aetherion<rt>에테리온</rt></ruby>  |
| 다른 언어의 표기 | `{검은 달\|Black Moon}` | <ruby>검은 달<rt>Black Moon</rt></ruby> |

원문이나 루비에는 여러 글자를 넣을 수 있지만, 너무 긴 문장을 한 번에 묶으면 원문과 보조 표기의 대응 관계를 읽기 어려울 수 있습니다. 단어나 짧은 구절 단위로 적용하는 편이 좋습니다.

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

### 에디터 툴바로 입력하기 [#에디터-툴바로-입력하기]

[에디터 툴바](/editor-functions/editor-toolbar)의 <TbLetterR style="{ display: 'inline' }" /> `루비`를 누른 뒤 **원문**과 **루비**를 입력하고 <TbCheck style="{ display: 'inline' }" /> `루비 적용`을 선택하세요. 먼저 본문 글자를 선택하면 원문 칸이 자동으로 채워집니다. 기존 루비를 선택하면 표기를 수정하거나 <TbTrash style="{ display: 'inline' }" /> `루비 제거`로 되돌릴 수 있습니다.

### 단축키로 입력하기 [#단축키로-입력하기]

`Ctrl + Shift + R`을 누르면 원문과 루비를 입력하는 도구가 열립니다. macOS에서는 `Command + Shift + R`을 사용합니다.

### 빠른 입력 방식 [#빠른-입력-방식]

`루비 자동 변환`은 기본으로 활성화되어 있습니다.[^ruby-auto-setting] `{원문|루비}` 형식의 마지막 `}`를 입력하면 곧바로 루비로 변환됩니다.

[^ruby-auto-setting]: 이 설정은 `뮤블 설정하기` → `위키` → `위키 조작` → `루비 자동 변환`에서 끄거나 다시 켤 수 있습니다.

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

| 형식        | 호환성      | 변환 결과                                     | 설명                                     |
| --------- | -------- | ----------------------------------------- | -------------------------------------- |
| HTML      | ✅ 호환     | `<ruby>원문<rt>루비</rt></ruby>`              | 표준 HTML 루비 요소로 내보냅니다.                  |
| Markdown  | ⚠️ 일부 호환 | `<ruby>원문<rt>루비</rt></ruby>`              | Markdown에 표준 루비 문법이 없어 HTML 요소를 사용합니다. |
| DOCX      | ⚠️ 일부 호환 | `원문(루비)`                                  | 루비를 괄호 안의 보조 표기로 바꿔 일반 글자로 내보냅니다.      |
| MediaWiki | ✅ 호환     | `<ruby>원문<rt>루비</rt></ruby>`              | HTML 루비 요소로 내보냅니다.                     |
| 나무위키      | ✅ 호환     | `{{{#!html <ruby>원문<rt>루비</rt></ruby>}}}` | HTML 매크로 안에 루비 요소를 넣어 내보냅니다.           |

## 관련 설정 [#관련-설정]

| 설정 및 위치 | 기본값 | 동작 |
| --- | --- | --- |
| 루비 자동 변환 — 위치: 뮤블 설정하기 → 위키 → 위키 조작 → 루비 자동 변환 | 사용 | `{원문\|루비}`를 입력하면 루비 서식으로 자동 변환합니다. |

***

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