제목은 모든 Markdown 문서의 척추입니다. 그들은 구조를 정의하고, 탐색을 가능하게 하고, 접근성에 영향을 미치고, SEO에 영향을 미칩니다. 이 안내서 는 Markdown 부문 문법, 계층 규칙, 플랫폼 차이, 그리고 우수한 관행.
제목 문법
Markdown 제목은 # 기호 (ATX 스타일) 수 # 문자가 표기준을 결정합니다.
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6또한 Setext 스타일 (H1과 H2만) 도 있습니다.
Heading 1
=========
Heading 2
---------ATX 방식 (#) 는 더 명확하고 6단계 모두에 적용됩니다.
각 주위 수준 의 의미
| 레벨 | HTML 태그 | 목적 |
|---|---|---|
| H1 | <h1> | 페이지 또는 문서 제목 |
| H2 | <h2> | 주요 섹션 |
| H3 | <h3> | H2 내의 하위 부분 |
| H4 | <h4> | H3 내의 하위 부분 |
| H5 | <h5> | 실무에서 거의 사용되지 않습니다 |
| H6 | <h6> | 거의 필요하지 않음 |
대부분의 문서들은 H1H3만을 사용합니다. H4H6는 보통 문서 구조가 너무 깊다는 것을 나타냅니다.
H1: 한 페이지당 1개
H1 제목은 Markdown 문서에 정확히 한 번 표시되어야 합니다. 문서의 제목 또는 페이지의 주요 주제를 나타냅니다.
잘됐어
# How to Convert Word to Markdown피하십시오:
# Section One
...
# Section Two ← Don't use multiple H1s검색 엔진과 접근성 도구는 한 페이지에 하나의 H1을 기대합니다. 여러 H1는 둘 다 혼동합니다.
제목 계층 규칙
항상 순서대로 진행하시오 레벨을 건너뛰지 마세요.
맞아요
# Document Title
## Section
### Subsection
#### Detail잘못된:
# Document Title
#### Jumped to H4 ← Skips H2 and H3헤드 레벨을 넘어서면 문서의 윤곽을 깨고 WCAG 접근성 가이드라인을 위반합니다.
Word 제목을 Markdown로 변환
Word 문서를 변환할 때 WordToMD, Word의 내장된 제목 스타일을 직접 매핑:
| Word 스타일 | Markdown 출력 |
|---|---|
| 부문 1 | # Heading |
| 부문 2 | ## Heading |
| 부문 3 | ### Heading |
| 정상 + 대고 | **Bold text** (부문 없음) |
가장 흔한 문제: 작가는 수동으로 대고 글꼴 크기를 늘리는 대신 헤딩 스타일을 적용합니다. 이것은 Word에서 헤드처럼 보이는 텍스트를 생성하지만 Markdown에서 일반 담백 텍스트로 변환합니다. 본문 Word에서 Markdown 포맷 가이드 어떻게 이 문제를 해결할 수 있는지에 대한
헤드 ID 및 앵커 링크
대부분의 Markdown 프로세서는 제목 텍스트에서 자동으로 ID를 생성합니다:
## Getting Started발전기: <h2 id="getting-started">Getting Started</h2>
링크를 통해:
See the [Getting Started section](#getting-started).자동 생성된 ID에 대한 규칙:
- 모든 문자를 소문자
- 간간을 교호로 교체
- 단호를 제외한 특별 문자를
예:
## API Reference→#api-reference## What's New?→#whats-new## Step 1: Install→#step-1-install
내용 표
긴 문서의 경우, 제목 앵커 링크를 사용하여 TOC를 생성합니다.
## Table of Contents
- [Installation](#installation)
- [Configuration](#configuration)
- [Basic Settings](#basic-settings)
- [Advanced Options](#advanced-options)
- [Usage](#usage)
- [FAQ](#faq)GitHub는 제목이 있는 Markdown 파일의 왼쪽 상단에 자동으로 TOC를 생성합니다.
SEO 고려 사항
정적 사이트 (Jekyll, Hugo, Astro) 에서 사용되고 웹에 공개된 Markdown의 경우:
- H1 = 페이지 제목 주요 키워드 를 입력 하십시오. 한 페이지마다 하나씩.
- H2s = 주요 섹션 자연스레 2차 키워드를 포함하세요
- H3s = 하위 섹션 더 구체적인 주제
- 제목을 설명 어떻게 의존성 설치 비트 설치
- 제목은 검색 엔진에 의해 인덱스 됩니다.
본문 Word가 정적 사이트 생성자로 웹에 Markdown 문서를 게시하기 위한 것입니다.
접근성
스크린 리더는 사용자들의 탐색을 돕기 위해 헤드 계층을 사용합니다. 지침:
- 방향 레벨을 건너뛰지 마십시오 (H1 → H3 H2 없이)
- 시각적 포맷을 위해 제목을 사용하지 마십시오 (그 대신 대담한 글자나 CSS를 사용하십시오)
- 제목 텍스트를 의미 있게 만들어야 합니다.
- 제목 을 간결 하지만 설명적 으로 유지 하십시오
플랫폼별로 표지
| 플랫폼 | H1-H6 | 자동 식별자 | 오토-토크 |
|---|---|---|---|
| GitHub | ✅ | ✅ | ✅ (버튼을 통해) |
| Obsidian | ✅ | ✅ | 플러그인을 통해 |
| GitBook | ✅ | ✅ | ✅ (사이드바) |
| Notion | H1-H3만 | ❌ | ❌ |
| VS 코드 미리보기 | ✅ | ✅ | ❌ |
| Confluence | ✅ | ✅ | ✅ |
Notion는 3개의 헤드 레벨만 지원합니다 (그들의 편집기에서는 헤드 1, 2 및 3이라고 부르고, H1H3로 매핑합니다).
일반적 인 실수
그 후의 공간을 잊고 #
#Not a heading ← Missing space
# This is correct그 사이의 공간은 # 그리고 제목 텍스트는 CommonMark에서 필요합니다.
스타일링을 위한 제목을 사용하는 것, 구조를 사용하지 않는 것
사용 ### 실제 서브섹션이 아닌 텍스트를 약간 작게 만드는 것은 문서 구조를 깨뜨립니다. 대신 스타일링 텍스트 또는 CSS 클래스를 사용하십시오.
과도한 둥지 조성 H5와 H6가 필요한 경우, 그 내용을 별도의 페이지로 나누어야 하는지를 고려하십시오.
FAQ
ATX 및 Setext 제목 스타일의 차이점은 무엇입니까?
ATX 사용 # 캐릭터들. 6번의 사용은 강조한다 (=== H1의 경우 --- H2의 경우) ATX는 명확하고 H1H6에 적합하기 때문에 선호됩니다.
H2가 여러 개 있으면 안되나요? 그래 그게 전부야 H2는 주요 섹션을 정의하고 문서에는 일반적으로 여러 가지가 있습니다.
경로를 건너가면 SEO에 영향을 미칠까요? 그것은 SEO보다 접근성에 직접적으로 영향을 미치지만 깨끗한 의미 구조는 긍정적 인 신호입니다. 검색 엔진은 잘 구성된 콘텐츠를 선호합니다.
제가 변환한 문서에는 모든 제목이 같은 수준에 있습니다. 무슨 일이 잘못됐어? Word 문서는 헤딩 스타일 대신 수동 포맷을 사용했습니다. 본문 Word에서 Markdown 포맷 가이드 그 치료에 대해
결론
Markdown 제목은 문법적으로 간단하지만 영향력이 중요합니다. 문서 제목으로 H1을 한 번, 주요 섹션에 H2를, 하부 섹션에 H3를 사용하십시오. 계층 순서를 깨끗하게 유지하고, 레벨을 넘기지 말고, 설명적인 헤드 텍스트를 작성하세요. Word 문서를 변환할 때 WordToMD, 원본이 Word의 내장된 헤딩 스타일을 사용하여 깨끗한 변환을 할 수 있도록 합니다.