# 컴포저에서 H1과 H2 제목 사용법

**URL:** https://meta.discourse.org/t/use-of-h1-vs-h2-headings-in-composer/397100
**Category:** Support
**Tags:** composer
**Created:** [2월 25, 2026, 6:18오후 UTC](https://meta.discourse.org/t/use-of-h1-vs-h2-headings-in-composer/397100 "2026-02-25T18:18:18Z")
**Posts on this page:** 20
**Page:** 1

<div class="post-metadata">

### Author: ![stephtara](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/stephtara/32/517827_2.png) [@stephtara](https://meta.discourse.org/u/stephtara)
#### Post date: [2월 25, 2026, 6:18오후 UTC](https://meta.discourse.org/t/use-of-h1-vs-h2-headings-in-composer/397100/1 "2026-02-25T18:18:18Z")

</div>

토픽에서 1단계 마크다운 헤딩(#)을 사용하면 HTML 출력에서 h1로 생성되나요, 아니면 h2로 생성되나요?

---

<div class="post-metadata">

### Author: ![Canapin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/canapin/32/119591_2.png) [@Canapin](https://meta.discourse.org/u/Canapin)
#### Post date: [2월 25, 2026, 8:16오후 UTC](https://meta.discourse.org/t/use-of-h1-vs-h2-headings-in-composer/397100/2 "2026-02-25T20:16:06Z")

</div>

`<h1>`를 출력합니다 🙂

---

<div class="post-metadata">

### Author: ![stephtara](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/stephtara/32/517827_2.png) [@stephtara](https://meta.discourse.org/u/stephtara)
#### Post date: [2월 25, 2026, 8:21오후 UTC](https://meta.discourse.org/t/use-of-h1-vs-h2-headings-in-composer/397100/3 "2026-02-25T20:21:09Z")

</div>

> [@Canapin](#):
>
> `<h1>`가 출력됩니다 🙂

그렇다면 Discourse가 페이지에 여러 개의 `<h1>` 태그가 있는 것을 권장한다는 뜻인가요? 토픽 제목이 `h1`이라면, 해당 토픽 내부의 1단계 제목은 기본적으로 `h2`여야 하지 않나요?

---

<div class="post-metadata">

### Author: ![Canapin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/canapin/32/119591_2.png) [@Canapin](https://meta.discourse.org/u/Canapin)
#### Post date: [2월 25, 2026, 8:30오후 UTC](https://meta.discourse.org/t/use-of-h1-vs-h2-headings-in-composer/397100/4 "2026-02-25T20:30:03Z")

</div>

Discourse는 아무것도 가정하지 않으며, 요청한 내용을 그대로 출력합니다.  
게시물 내에서 최상위 제목으로 `###`을 사용하는 것이 더 나은 관행임이 확실합니다 🙂

수정: [Use of H1 vs. H2 headings in composer - #16 by Canapin](https://meta.discourse.org/t/use-of-h1-vs-h2-headings-in-composer/397100/16?u=canapin) 참고

---

<div class="post-metadata">

### Author: ![stephtara](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/stephtara/32/517827_2.png) [@stephtara](https://meta.discourse.org/u/stephtara)
#### Post date: [2월 25, 2026, 8:36오후 UTC](https://meta.discourse.org/t/use-of-h1-vs-h2-headings-in-composer/397100/5 "2026-02-25T20:36:10Z")

</div>

> [@Canapin](#):
>
> 글 안에서 최상위 헤딩으로 `##`을 사용하는 것이 더 나은 관행임에 틀림없습니다 🙂

`#`을 1단계 헤딩으로 설정하지 않으면 우리가 스스로 할 수 있는 "사용자 교육"을 생략할 수 있을 것 같다는 생각이 드네요… 😰

이를 변경할 방법이 있는지 아시나요? 아니면 최소한 툴바에서 1단계 헤딩을 숨길 수는 없나요? (Markdown을 직접 작성하는 사람들이 현실적인 교육 대상이 될 것이라고 추측하고 있습니다…)

---

<div class="post-metadata">

### Author: ![Canapin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/canapin/32/119591_2.png) [@Canapin](https://meta.discourse.org/u/Canapin)
#### Post date: [2월 25, 2026, 9:27오후 UTC](https://meta.discourse.org/t/use-of-h1-vs-h2-headings-in-composer/397100/6 "2026-02-25T21:27:21Z")

</div>

> [@stephtara](#):
>
> 이걸 변경할 방법이 있는지 아시나요? 아니면 최소한 툴바에서 1단계 제목을 숨길 수는 없나요?

네, 꽤 간단합니다. 리스트 요소에는 `data-name="heading-1"`이라는 속성이 있어 CSS로 이를 표적 지정할 수 있습니다. 🙂

---

<div class="post-metadata">

### Author: ![ToddZ](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/toddz/32/328350_2.png) [@ToddZ](https://meta.discourse.org/u/ToddZ)
#### Post date: [2월 25, 2026, 9:49오후 UTC](https://meta.discourse.org/t/use-of-h1-vs-h2-headings-in-composer/397100/7 "2026-02-25T21:49:22Z")

</div>

히히 - 나도 방금 확인하고 있었어. 간단한 테스트 결과, 이 코드가 마크다운과 리치 텍스트 에디터 모두에서 H1 옵션을 숨긴다:

```css
button[data-name="heading-1"] {
  display: none;
}

```

(이걸 그대로 유지할지도! 에디터에서 H1을 제공할 이유가 별로 없는 것 같아서.)

---

<div class="post-metadata">

### Author: ![bryce](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/bryce/32/377822_2.png) [@bryce](https://meta.discourse.org/u/bryce)
#### Post date: [2월 25, 2026, 10:16오후 UTC](https://meta.discourse.org/t/use-of-h1-vs-h2-headings-in-composer/397100/8 "2026-02-25T22:16:47Z")

</div>

> [@stephtara](#):
>
> `#`를 1단계 제목으로 만들지 않으면 우리가 스스로 피할 수 있는 “사용자 교육”이 분명히 있다고 생각합니다… 😰

그 점은 이해합니다. 하지만 이는 Discourse가 특정 방향으로 굳이 결정했다는 것은 아닙니다. Discourse는 CommonMark라는 마크다운 규약을 따르며, 이 규약은 `#`가 H1로 변환되어야 한다고 [규정](https://spec.commonmark.org/0.31.2/#atx-headings)하고 있습니다. 마크다운 제목이 HTML 태그로 변환되는 방식에 대한 이 규정은 주요 마크다운 사양 전반에서 꽤 표준적인 것이라 생각합니다.

---

<div class="post-metadata">

### Author: ![Jagster](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jagster/32/192154_2.png) [@Jagster](https://meta.discourse.org/u/Jagster)
#### Post date: [2월 26, 2026, 7:30오전 UTC](https://meta.discourse.org/t/use-of-h1-vs-h2-headings-in-composer/397100/9 "2026-02-26T07:30:09Z")

</div>

> [@stephtara](#):
>
> 이건 확실히 "사용자 교육"이긴 하네요.

솔직히 `<h1>` 헤딩이 두 개라는 건 그렇게 큰 문제가 아닙니다. 이미 오래된 SEO 미신에 가까워서, 꽤 오래전부터 더 이상 이슈가 되지 않고 있거든요. Google 등은 첫 번째 헤딩이나, 가장 적합하다고 판단되는 것을 사용합니다.

콘텐츠 관점에서 두 개의 메인 헤딩이 최선의 선택인지에 대해서는 논의해 볼 수 있지만, 플랫폼이 주제 이름과 게시글 내 헤딩에 서로 다른 스타일을 적용한다면 실제로는 큰 의미가 없습니다.

그래도 게시글에서는 `##`/`<h2>`를 사용하는 것이 더 적합합니다. 하지만 실제로 아무 역할도 하지 않기 때문에, 제 생각에는 “잘못된” 헤딩을 사용할까 봐 두려워하는 사용자들을 위해 그런 헤딩을 피할 수 있는 다른 헤딩을 사용하는 것이 더 낫다고 봅니다. 🤷‍♂️

---

<div class="post-metadata">

### Author: ![ToddZ](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/toddz/32/328350_2.png) [@ToddZ](https://meta.discourse.org/u/ToddZ)
#### Post date: [2월 26, 2026, 8:24오전 UTC](https://meta.discourse.org/t/use-of-h1-vs-h2-headings-in-composer/397100/10 "2026-02-26T08:24:37Z")

</div>

제목은 오늘날 SEO에 있어 작은 신호일 수 있지만, 여전히 여러 개의 H1 태그를 사용하는 것을 싫어합니다. 왜냐하면 나는 그 분야에 대해 집착이 있으니까요. 🤓

또한 Steph가 Page Publishing을 위해 인쇄 가능한 문서를 만들고 있는데, 포스트 안의 H1이 페이지 상단의 H1보다 더 크게 렌더링되는 문제를 생각하고 있습니다:

> **image**
>
> ![image](https://global.discourse-cdn.com/meta/original/4X/3/7/0/370f304c1e740a2a396c29937d74dd224b65922c.png)

이들을 H2로 변경하면 상단의 H1보다 약간 작게 유지됩니다:

> **image**
>
> ![image](https://global.discourse-cdn.com/meta/original/4X/c/8/4/c84c49753f1d4d19adf0e738e253a97364d12c98.png)

---

<div class="post-metadata">

### Author: ![stephtara](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/stephtara/32/517827_2.png) [@stephtara](https://meta.discourse.org/u/stephtara)
#### Post date: [2월 26, 2026, 8:39오전 UTC](https://meta.discourse.org/t/use-of-h1-vs-h2-headings-in-composer/397100/11 "2026-02-26T08:39:33Z")

</div>

그래서 그게 문제인 거예요. 제 입장에서는 1단계 헤더를 먼저 사용하는 게 자연스러운데, 테마가 같은 전제 하에 스타일이 적용되지 않으면 엉망이 되죠. 여기 어딘가에서 뭔가 어긋나는 부분이 있는 것 같아요.

(참고: 제가 개입하지 않았는데도 문서가 영어로 표시되고 있는 건가요?!?)

---

<div class="post-metadata">

### Author: ![ToddZ](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/toddz/32/328350_2.png) [@ToddZ](https://meta.discourse.org/u/ToddZ)
#### Post date: [2월 26, 2026, 9:00오전 UTC](https://meta.discourse.org/t/use-of-h1-vs-h2-headings-in-composer/397100/12 "2026-02-26T09:00:44Z")

</div>

> [@stephtara](#):
>
> 제게는 첫 번째 레벨 헤더를 먼저 사용하는 것이 자연스럽습니다.

맞아요, 자연스럽고 웹 페이지를 처음부터 만드는 경우에는 그럴 수 있습니다. 하지만 CMS나 게시 시스템은 거의 항상 페이지의 H1을 제목 필드에서 가져오기 때문에, 콘텐츠 섹션에는 보통 H2를 사용하게 됩니다.

(그리고 저는 웹 브라우저의 번역 도구를 사용해 영어를 확인했습니다.)

---

<div class="post-metadata">

### Author: ![stephtara](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/stephtara/32/517827_2.png) [@stephtara](https://meta.discourse.org/u/stephtara)
#### Post date: [2월 26, 2026, 9:11오전 UTC](https://meta.discourse.org/t/use-of-h1-vs-h2-headings-in-composer/397100/13 "2026-02-26T09:11:13Z")

</div>

동의합니다. 하지만 제 생각에는 커뮤니티 멤버들이 그걸 알아야 한다는 기대를 해서는 안 됩니다.

---

<div class="post-metadata">

### Author: ![ToddZ](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/toddz/32/328350_2.png) [@ToddZ](https://meta.discourse.org/u/ToddZ)
#### Post date: [2월 26, 2026, 9:55오전 UTC](https://meta.discourse.org/t/use-of-h1-vs-h2-headings-in-composer/397100/14 "2026-02-26T09:55:42Z")

</div>

> [@stephtara](#):
>
> 커뮤니티 구성원들이 이를 알아야 한다는 것을 기대해서는 안 됩니다

네 – 그리고 [H1 옵션을 단순히 숨기는 것](https://meta.discourse.org/t/use-of-h1-vs-h2-headings-in-composer/397100/7)에는 단점이 없다고 봅니다.

다만 대부분의 사용자들이 일반적인 게시글을 작성할 때 헤딩을 많이 사용하지는 않는 것 같습니다. 더 긴 문서형 토픽을 작성하는 분들은 아마 `##`와 그 “TT” 아이콘에 대해 조금 더 익숙하거나, 곧 익숙해질 것입니다.

---

<div class="post-metadata">

### Author: ![ToddZ](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/toddz/32/328350_2.png) [@ToddZ](https://meta.discourse.org/u/ToddZ)
#### Post date: [2월 26, 2026, 10:34오전 UTC](https://meta.discourse.org/t/use-of-h1-vs-h2-headings-in-composer/397100/15 "2026-02-26T10:34:13Z")

</div>

그리고: 제목은 주제(topic)에서만 사용되고, 답변에서는 사용해서는 안 된다는 제기가 담긴 흥미로운 오래된 토론을 방금 발견했습니다: [Disable headers in replies like h1 and h2](https://meta.discourse.org/t/disable-headers-in-replies-like-h1-and-h2/81775)

혹시 관심 있으신 분을 위해, 이 작은 스니펫은 _답변을 작성할 때에만_ 작성기에서 “TT” 제목 아이콘을 완전히 숨깁니다:

```css
.composer-action-reply button.heading {
  display: none;
}

```

---

<div class="post-metadata">

### Author: ![Canapin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/canapin/32/119591_2.png) [@Canapin](https://meta.discourse.org/u/Canapin)
#### Post date: [2월 26, 2026, 11:34오전 UTC](https://meta.discourse.org/t/use-of-h1-vs-h2-headings-in-composer/397100/16 "2026-02-26T11:34:11Z")

</div>

제목(Heading)은 SEO만을 위한 것이 아니라 접근성(Accessibility)에도 중요합니다.

스크린 리더는 제목에서 제목으로 이동할 수 있으며, 키보드 단축키를 통해 제목의 위계(깊이)를 지정할 수 있습니다.

토픽에는 각각 `<h1>` 제목이 있지만, 모든 답변에는 스크린 리더에서 보이는 숨겨진 `<h2>`가 앞에 붙습니다:

```html
<h2 aria-hidden="false" class="sr-only" id="post-heading-9">
  post by Jagster 4 hours ago
</h2>

```

따라서 어떤 경우든 콘텐츠에 `<h1>` 또는 `<h2>` 제목을 게시하더라도, 항상 이미 존재하는 `<h2>`의 자식 요소(descendant)가 됩니다 🙃

따라서 게시물에서 `<h3>`보다 상위 제목을 사용하면 스크린 리더 내비게이션이 다소 어색해질 수 있다고 생각합니다.

기존 토픽들 사이에서 일관성은 없지만, #customization:플러그인 의 게시물 템플릿은 최상위 제목으로 `<h3>`을 사용합니다:

```plaintext
| | | |
| - | - | - |
| :information_source: | **요약** | 이 플러그인이 무엇을 하는지 몇 마디로 설명해 주세요. |
| :hammer_and_wrench: | **리포지토리 링크** | <> |
| :open_book: | **설치 가이드** | [Discourse에서 플러그인 설치 방법](https://meta.discourse.org/t/install-plugins-in-discourse/19157) |

<br>  

### 기능
 
플러그인의 주요 기능을 설명해 주세요
 
### 설정

플러그인을 설정하는 방법에 대한 자세한 단계를 포함해 주세요 (필요한 경우 스크린샷 포함)

### 설정 항목 
 
설정 항목과 설명을 담은 표를 포함해 주세요

| 이름 | 설명
|-|-|
|

```

흥미롭게도, #customization:테마 와 #customization:테마-컴포넌트 템플릿의 경우 그렇지 않습니다. 하지만 해당 템플릿에는 제목이 포함되어 있지 않습니다. 아마도 이 부분을 변경해야 할 것 같습니다.

---

<div class="post-metadata">

### Author: ![stephtara](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/stephtara/32/517827_2.png) [@stephtara](https://meta.discourse.org/u/stephtara)
#### Post date: [2월 26, 2026, 11:37오전 UTC](https://meta.discourse.org/t/use-of-h1-vs-h2-headings-in-composer/397100/17 "2026-02-26T11:37:15Z")

</div>

동의합니다. 저도 좀 더디기라 할 수 있고, 제목 위계를 깔끔하게 유지하는 걸 좋아합니다.  
사실 게시글에서는 제대로 하려면 h3, h4, h5만 사용해야 합니다. 이 문제를 ‘수정’해 주는 테마 컴포넌트가 있으면 흥미로울 것 같은데, 그러면 버튼에서 상위 제목 레벨을 제거하고, 주제에서 h3 이하의 스타일링을 ‘변환’해서 우리가 사용할 때 제대로 보이도록 해야 할 텐데요…?

---

<div class="post-metadata">

### Author: ![Moin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/moin/32/554653_2.png) [@Moin](https://meta.discourse.org/u/Moin)
#### Post date: [2월 26, 2026, 12:24오후 UTC](https://meta.discourse.org/t/use-of-h1-vs-h2-headings-in-composer/397100/18 "2026-02-26T12:24:38Z")

</div>

###### 게시물에 한 단계 더 필요한 경우를 위해 h6도 있지만, 글자가 아주 작습니다

H5도 게시물 일반 텍스트보다 작아서, 제가 사용하겠는지 확실하지 않습니다

##### 이것은 h5입니다

---

<div class="post-metadata">

### Author: ![ToddZ](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/toddz/32/328350_2.png) [@ToddZ](https://meta.discourse.org/u/ToddZ)
#### Post date: [2월 26, 2026, 12:32오후 UTC](https://meta.discourse.org/t/use-of-h1-vs-h2-headings-in-composer/397100/19 "2026-02-26T12:32:55Z")

</div>

> [@Canapin](#):
>
> 토픽에는 `<h1>` 제목이 있지만, 모든 답변에는 스크린 리더로만 보이는 숨겨진 `<h2>`가 앞에 붙습니다.

아, 그걸 몰랐네요! 아마도 Pfaffman의 "게시물의 첫 번째 수준의 헤더는 h3여야 한다"는 코멘트를 설명해 주는 것 같습니다. \[1\]

그렇다면 CSS 해킹은 다음과 같이 됩니다:

```css
button[data-name="heading-1"], button[data-name="heading-2"] {
  display: none;
}

```

접근성 문제를 해결해 주셔서 감사합니다. 저도 그 점을 항상 염두에 두도록 하겠습니다.

* * *

1. [source](https://meta.discourse.org/t/disable-headers-in-replies-like-h1-and-h2/81775/2)

---

<div class="post-metadata">

### Author: ![ToddZ](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/toddz/32/328350_2.png) [@ToddZ](https://meta.discourse.org/u/ToddZ)
#### Post date: [2월 26, 2026, 12:42오후 UTC](https://meta.discourse.org/t/use-of-h1-vs-h2-headings-in-composer/397100/20 "2026-02-26T12:42:00Z")

</div>

> [@stephtara](#):
>
> … 토픽에서 h3 이하의 스타일링을 번역하여(적용하여) 사용할 때 올바르게 보이도록 조정하는 중입니다

H3~H5의 스타일을 조정할 수도 있고… 그대로 두는 것이 더 나을 수도 있습니다:

 ![Subheading as H3 on your published page](https://global.discourse-cdn.com/meta/original/4X/d/2/7/d27462a962b563bf7804a81777952fccf4ae9fb4.png)

[다음 페이지](https://meta.discourse.org/t/use-of-h1-vs-h2-headings-in-composer/397100.md?page=2)
