제목과 목차
Markdown headings
마크다운에서 일반적으로 제목 단락을 만드는 방법을 사용할 수 있습니다.
## Level 2 title
### Level 3 title
#### Level 4 title
각 마크다운 제목 단락은 목차에 표시됩니다.
Heading IDs
각 제목 단락은 자동으로 생성되거나 별도 지정한 ID 값을 가집니다. 제목 단락 ID는 마크다운이나 JSX에서 해당 문서에 대한 링크를 작성할 때 사용할 수 있습니다.
[link](#heading-id)
<Link to="#heading-id">link</Link>
기본적으로 도큐사우루스에서는 제목 단락 텍스트에 따라 ID를 자동으로 생성합니다. For example, ### Hello World
will have ID hello-world
.
Generated IDs have some limitations:
- ID가 직관적이지 않을 수 있습니다.
- You might want to change or translate the text without updating the existing ID
A special Markdown syntax lets you set an explicit heading id:
### Hello World {#my-explicit-id}
Use the write-heading-ids
CLI command to add explicit IDs to all your Markdown documents.
생성된 제목 단락 ID는 각 페이지에서는 고유한 것이 보장되지만 사용자 지정 ID를 사용하는 경우에는 각 ID가 각 페이지에서 정확하게 한 번만 표시되는지 확인하세요. 그렇지 않으면 같은 ID를 가진 두 개의 DOM 요소가 존재하게 됩니다. 이는 잘못된 HTML이며 제목과 적절하게 연결할 수 없게 됩니다.
Table of contents heading level
마크다운 문서는 화면 오른쪽 상단에 목차를 보여줍니다. 기본적으로 목차에서는 h2, h3 제목만 표시하므로 페이지 구조를 한 눈에 보기에 충분합니다. 표시되는 제목 범위를 수정하고자 한다면 페이지 단위 또는 전역적으로 최소, 최대 제목 수준을 지정할 수 있습니다.
To set the heading level for a particular page, use the toc_min_heading_level
and toc_max_heading_level
front matter.
---
# h2부터 h5까지 제목을 표시합니다
toc_min_heading_level: 2
toc_max_heading_level: 5
---