🇨🇳 Discourse 게시물 서식 가이드 — 포맷을 추가해 게시물을 더 다채롭게

[Dotila_Li]

때로는 게시글에 작은 수정을 가하는 것만으로 가독성과 상호작용을 크게 향상시킬 수 있습니다! 이 글에서는 게시글 형식과 관련된 이러한 '작은 수정’들을 소개합니다.

지금 바로 게시글 편집기를 열고 따라 해보시는 것을 권장합니다. 게시글 편집기에는 미리보기 페이지가 내장되어 있습니다:

잠시 물을 한 모금 마시고, 허리를 늘려보세요. 게시글 편집기를 여는 준비가 되셨나요? 자, 시작합니다!

---

제목

줄 앞에 # 기호를 추가하면 해당 줄의 내용을 제목으로 변환할 수 있으며, # 기호의 개수는 제목의 수준을 나타냅니다.

입력:

# 1급 제목
## 2급 제목
### 3급 제목
#### 4급 제목

결과:

게시글의 내용이 많고 구조가 있는 경우, 제목을 추가하면 독자가 게시글의 내용 구조를 더 쉽게 이해할 수 있어 게시글이 더 명확해집니다.

게시글 안의 제목에는 해당 제목으로 이동하는 링크가 자동으로 추가됩니다(마우스를 제목 위에 올리면 해당 링크를 나타내는 기호 를 볼 수 있습니다). 이를 통해 링크를 사용하여 특정 제목으로 빠르게 이동할 수 있습니다.

# 기호와 제목 내용 사이에 공백이 있어야 한다는 점에 유의하세요.

굵은 글씨를 제목으로 사용하는 분들이 계실 수 있지만, 대부분 권장하지 않습니다. 굵은 글씨에는 제목 형식의 의미론적 구조, 계층, 자동 링크가 없으며, 아래에서 소개할 목차 형식을 위한 준비도 할 수 없기 때문입니다.

게시글을 작성할 때 가장 큰 제목은 1급 제목이 아닌 2급 제목을 사용하는 것을 권장합니다. 1급 제목은 이미 주제 대제목으로 사용되고 있기 때문입니다.

---

목차

이 게시글에는 목차가 있다는 점을 알아차리셨을 것입니다. 스마트폰을 사용 중이라면 오른쪽 하단의 목차 버튼을 클릭하여 열 수 있습니다. 컴퓨터를 사용 중이라면 목차가 화면 오른쪽에 표시됩니다.

게시한 주제 글에 제목이 있는 경우, 게시글에 이러한 목차를 추가할 수 있습니다.

추가 방법: 게시글에 몇 개의 제목이 있는지 확인하세요(이러한 제목으로 목차가 구성됩니다). 편집기에서 커서를 빈 줄에 두세요. 그런 다음 아래 그림에 표시된 버튼을 클릭하세요.

이 버튼을 클릭하면 편집기에 영어 기호 한 줄이 나타납니다:

 <div data-theme-toc="true"> </div>

이 기호는 목차를 자동으로 생성하는 데 사용되며, 게시한 글에는 표시되지 않으므로 삭제할 수 없습니다. 그대로 두세요. 그리고 게시글 내용을 계속 작성하세요. 게시글을 게시하면 목차를 볼 수 있습니다.

목차는 제목을 한 곳에 모아 보여주고 해당 제목 내용으로 빠르게 이동할 수 있게 해줍니다. 주제 글에 제목이 있는 경우, 목차를 추가하는 것이 좋은 선택입니다!

---

굵은 글씨, 기울임, 강조

입력:

쌍 별표로 둘러싸인 것은 **굵은 글씨**입니다
단일 별표로 둘러싸인 것은 *기울임*입니다
<mark>강조</mark>할 텍스트 양쪽에 특수 기호 두 개를 추가합니다.

결과:
쌍 별표로 둘러싸인 것은 굵은 글씨입니다
단일 별표로 둘러싸인 것은 기울임입니다
강조할 텍스트 양쪽에 특수 기호 두 개를 추가합니다.

굵은 글씨는 눈에 잘 띄므로 중요한 정보를 강조하는 데 적합합니다.

기울임 글씨도 강조에 사용될 수 있으며, 때로는 외국어, 특수 명사 또는 고유 명사를 나타내거나 주변 일반 텍스트와 구별하는 데 사용됩니다.

강조(하이라이트)도 눈에 잘 띄므로 필요에 따라 사용하세요.

---

인용

문단 앞에 > 기호를 추가하면 해당 문단에 인용 형식을 적용할 수 있습니다.
입력:

> 백모가 푸른 물 위에 떠 있고, 붉은 발이 맑은 물결을 헤칩니다.

결과:

백모가 푸른 물 위에 떠 있고, 붉은 발이 맑은 물결을 헤칩니다.

하나의 인용 블록은 여러 문단을 포함할 수 있습니다. 문단 사이의 빈 줄에는 > 기호를 추가해야 합니다.
입력:

> 첫 번째 문단의 내용.
>
> 두 번째 문단의 내용.

결과:

첫 번째 문단의 내용.

두 번째 문단의 내용.

인용 형식은 타인의 글, 창작물 등 기타 출처의 내용을 인용하는 데 자주 사용됩니다.

인용 블록의 시각적 효과는 인용된 내용을 더 두드러지게 보여주고, 게시글에서 어떤 부분이 인용된 글이고 어떤 부분이 게시자의 글인지 쉽게 구분할 수 있게 하여 한눈에 파악할 수 있게 합니다.

---

포럼 내용 인용

포럼의 특정 게시글 중 특정 구절을 인용하고 싶을 경우, 아래 인용 방법을 사용할 수 있습니다.
결과:

사용 방법:
인용하려는 텍스트를 선택하면 “인용” 버튼이 나타납니다. 이 버튼을 클릭하면 편집기가 자동으로 열리고 해당 텍스트의 인용 형식이 자동으로 생성됩니다.

특정 게시글의 구절을 인용/답변할 때, 이러한 인용은 다른 포럼 방문자에게 어떤 게시자의 어떤 문장을 인용/답변하고 있는지 명확히 알려주고, 인용된 내용의 맥락을 쉽게 확인하게 해줍니다. 이는 토론을 명확하게 만듭니다.

---

구분선

빈 줄에 - 기호 세 개를 입력하면 구분선이 생성됩니다.
입력:

---

결과: 이 게시글의 각 제목 위에 구분선이 있습니다!

구분선의 위 줄은 빈 줄이어야 합니다. 그렇지 않으면 이상한 결과가 나타날 수 있습니다(직접 시도해 보세요).

---

여러 빈 줄

때로는 위아래 내용 사이에 여러 개의 빈 줄을 넣고 싶을 때가 있습니다. 직관적이지 않은 점은, 입력에 여러 개의 빈 줄이 포함되어 있어도 표시 효과에는 최대 하나의 빈 줄만 나타나는 것입니다. 이 경우 여러 개의 빈 줄을 강제 추가하려면 빈 줄 위치에 <br> 특수 문자를 입력해야 합니다. 예를 들어 다음과 같습니다.
입력:

위 내용과 아래 내용 사이에 두 개의 빈 줄이 더 있습니다
<br>
<br>
아래 내용과 위 내용 사이에 두 개의 빈 줄이 더 있습니다

결과:
위 내용과 아래 내용 사이에 두 개의 빈 줄이 더 있습니다




아래 내용과 위 내용 사이에 두 개의 빈 줄이 더 있습니다

---

주석

주석에는 두 가지 형태가 있습니다:
인라인 주석
입력:

주석이 필요한 문장 ^[주석 내용] 
주석이 필요한 또 다른 문장 ^[또 다른 주석 내용]

결과:

주석이 필요한 문장 ^[1]
주석이 필요한 또 다른 문장 ^[2]

비인라인 주석
입력:

주석이 필요한 문장 [^1]
주석이 필요한 또 다른 문장 [^2]

[^1]: 주석 내용
[^2]: 또 다른 주석 내용

결과:

---

상세 정보 숨기기

예시:

사용 진입점:

게시글에 길고 상대적으로 부차적인 내용이 있는 경우, 이 기능을 사용하여 해당 내용을 숨길 수 있습니다.

---

형식 빠른 추가 버튼

일부 형식은 편집기의 버튼을 통해 추가할 수 있습니다.

---

기타 형식

위에서 몇 가지 중요한 형식에 대해 소개했습니다. 배울 수 있었나요? 나머지 형식은 여러분이 직접 탐색해 보세요.
의문이 있으면 포럼 피드백 구역에 댓글을 남겨주세요. 즐거운 게시글 작성 되시길 바랍니다!

참고 자료:

• Markdown 공식 튜토리얼
• Supported formatting in posts

---

1. 주석 내용 ↩︎

2. 또 다른 주석 내용 ↩︎

[wellbing-go]

좋아요 더 많은 튜토리얼을 기대합니다

[yoke_snowwolf (snaper)]

@Dotila_Li
오른쪽 슬라이더의 마크다운 목차 섹션이 표시되도록 설정하는 방법을 여쭤봐도 될까요? 특정 플러그인이 필요한 건가요?

[Moin]

이것은 DiscoTOC - automatic table of contents Customization > Theme component 입니다

DiscoTOC 자동 콘텐츠 목차

概述 DiscoTOC 允许你针对你的主题一键创建一个内容列表。 预览 Beginner's guide to using Discourse Themes （请在一个新的标签页上访问链接） 仓库链接 https://github.com/discourse/DiscoTOC 对 Discourse 主题没有了解？ 请访问官方网页中有关 Beginner’s guide to using Discourse Themes 的 示例 桌面 [image] 移动终端 [image] 特性 toc = table of contents（内容列表） 通过菜单上面的设置按钮，根据当前内容的状况一键生成 toc 列表 Toc 将会一直在页面中尽显显示 —— 滚动内容与 topic 的链接是同步的 当你滚动过当前页面中中的主题的时候，对应这个主题的内容列表将会使用高亮来进行显示（显示为绿色） 针对标题添加属性（…

[yoke_snowwolf (snaper)]

감사합니다!
정말 좋습니다!