LaTeX의 상호 참조: \label과 \ref
참조하려는 대상 바로 뒤(\section{...} 뒤, \caption{...} 뒤, 수식 안)에 \label{key}를 두고, 번호가 들어갈 자리에 \ref{key}를 쓰세요. Scissor LaTeX가 조판할 때 번호를 채워 넣습니다.
레이블을 달고 참조하기
상호 참조는 두 부분으로 이루어집니다. \label{key}는 번호가 붙는 대상에 표시를 하고, \ref{key}는 그 번호를 출력합니다. 키는 원하는 이름이면 무엇이든 됩니다. sec:, fig:, tab:, eq: 같은 접두사는 키를 읽기 쉽게 해 주는 관례일 뿐 규칙은 아닙니다.
절과 그림 참조하기
\section{Results}
\label{sec:results}
\begin{figure}[h]
\centering
\begin{tikzpicture}
\draw (0,0) -- (1,0.8) -- (2,0.3) -- (3,1.1);
\end{tikzpicture}
\caption{Measured values.}
\label{fig:values}
\end{figure}
Section~\ref{sec:results} shows the values in Figure~\ref{fig:values}.
단어와 참조 사이의 ~는 줄바꿈되지 않는 공백이므로, "Figure"와 그 번호가 같은 줄에 머뭅니다.
레이블을 두는 위치
레이블은 그 앞에 있는 가장 가까운 번호 붙은 대상의 번호를 가져갑니다.
| 참조 대상 | \label을 두는 곳 | \ref가 출력하는 것 |
|---|---|---|
| 절 | \section{...}(또는 \subsection, \chapter) 바로 뒤 | 2, 2.1 |
| 그림이나 표 | 플로트 안, \caption{...} 뒤 | 1 |
| 수식 | equation이나 번호 붙은 align 안 | 1 |
| 목록 항목 | enumerate의 \item 뒤 | 2, 2b |
| 정리 | theorem, lemma 같은 환경 안 | 1 |
| 각주 | \footnote{...} 텍스트 안 | 2 |
수식
\eqref{key}는 수식 번호를 흔히 쓰는 방식대로 괄호 안에 출력합니다. \ref{key}는 번호만 출력합니다.
수식에 대한 \eqref와 \ref
\begin{equation}
a^2 + b^2 = c^2
\label{eq:pythagoras}
\end{equation}
Equation~\eqref{eq:pythagoras} is famous; its number is \ref{eq:pythagoras}.Scissor LaTeX에서 align이나 gather 블록은 행마다가 아니라 블록 전체에 번호 하나를 받습니다. 블록의 첫 \label만 남으므로, 뒤쪽 행의 레이블을 참조하면 ??가 출력됩니다. 자세한 내용은 수식, 정렬, 번호 매기기를 참고하세요.
이름을 붙여 주는 명령: \autoref와 \cref
(hyperref의) \autoref와 (cleveref의) \cref는 대상의 종류를 번호와 함께 출력하므로 "Figure"를 직접 쓸 필요가 없습니다. \cref는 cleveref의 기본값을 따라 소문자 약칭("fig.", "eq.")을 쓰며, 문장 첫머리에서 \Cref를 쓰면 대문자로 시작하는 전체 이름이 됩니다.
\autoref, \cref, \Cref
\section{Method}
\label{sec:method}
\begin{equation}
y = 44x
\label{eq:line}
\end{equation}
\begin{table}[h]
\centering
\caption{Settings.}
\label{tab:settings}
\begin{tabular}{lr} Runs & 44 \\ \end{tabular}
\end{table}
\autoref{sec:method} uses \cref{tab:settings} and \cref{eq:line}.
\Cref{tab:settings} lists the runs.
cleveref는 여러 레이블을 한꺼번에, 그리고 범위로도 참조할 수 있습니다.
\cref로 쓰는 목록과 범위
\begin{equation} a = 1 \label{eq:a} \end{equation}
\begin{equation} b = 2 \label{eq:b} \end{equation}
See \cref{eq:a,eq:b}, or \crefrange{eq:a}{eq:b}.패키지 옵션 capitalise(또는 capitalize), noabbrev, nameinlink가 읽히며, 프리앰블의 \crefname과 \Crefname도 읽힙니다.
cleveref 옵션과 \crefname
\documentclass{article}
\usepackage{amsmath}
\usepackage[capitalise,noabbrev]{cleveref}
\crefname{table}{Tab.}{Tabs.}
\begin{document}
\begin{equation} E = mc^2 \label{eq:e} \end{equation}
\begin{table}[h]
\centering
\caption{Masses.}
\label{tab:m}
\begin{tabular}{l} 44 kg \\ \end{tabular}
\end{table}
\cref{eq:e} uses the mass in \cref{tab:m}.
\end{document}
| 명령 | Scissor LaTeX에서 | 참고 |
|---|---|---|
\ref{key} | 동작함 | 번호만 출력합니다. |
\eqref{key} | 동작함 | 번호를 괄호 안에 출력합니다. |
\pageref{key} | 동작함 | 레이블이 있는 페이지 번호를 출력합니다. |
\autoref{key} | 일부 | "Section 2", "Figure 1", "Table 1", "Theorem 1". 수식에서는 "Equation 1"이 아니라 번호만 출력합니다. |
\cref, \Cref | 동작함 | 레이블 하나 또는 여러 개. cleveref의 기본 이름이나 \crefname으로 정한 이름을 씁니다. |
\crefrange, \cpageref, \namecref | 동작함 | 범위, 페이지, 또는 이름만 출력합니다. |
\nameref{key} | 일부 | 절 제목이 아니라 번호를 출력합니다. |
\vref{key} | 일부 | "on the next page" 없이 번호를 출력합니다. |
\hyperref[key]{text} | 동작함 | 내 텍스트를 레이블로 가는 링크로 출력합니다. |
페이지와 없는 레이블
\pageref는 레이블이 있는 페이지를 출력합니다. 존재하지 않는 레이블을 참조하면 LaTeX가 두 번째 실행 전에 그러듯 굵은 ??가 출력되며, 문제 탭에 없는 레이블이 각각 한 번씩 나열됩니다: "References to labels that do not exist (shown as ??): sec:nowhere".
\pageref와 없는 레이블
\section{Data}
\label{sec:data}
The data is described on page~\pageref{sec:data}.
This label does not exist: Section~\ref{sec:nowhere}.문제 탭: References to labels that do not exist (shown as ??): sec:nowhere
TeX 설치 환경과 다른 점
패키지는 cleveref와 hyperref를 참고하세요. 전체 설명서는 CTAN에 있습니다: cleveref, hyperref.
질문과 답변
LaTeX에서 왜 참조가 ??로 표시되나요?
레이블이 없거나 \ref와 철자가 다릅니다. Scissor LaTeX에서는 그 레이블이 번호를 하나만 받는 align 블록의 두 번째 레이블이라는 뜻일 수도 있습니다.
수식을 괄호와 함께 참조하려면 어떻게 하나요?
amsmath의 \eqref{key}를 쓰세요. (1)처럼 번호를 괄호 안에 출력합니다.
\ref와 \autoref는 어떻게 다른가요?
\ref는 번호만 출력합니다. \autoref는 "Figure 1"이나 "Section 2"처럼 종류를 덧붙여 주므로 그 단어를 직접 쓰지 않아도 됩니다.
이 페이지의 모든 예제는 사이트를 빌드할 때 Scissor LaTeX로 조판됩니다. 마지막 업데이트: 2026-11-07