## 1. 마크다운이란?
**마크다운(Markdown)** 은 문서 작성 시 간단한 기호를 통해 텍스트에 서식(헤더, 볼드, 표, 링크 등)을 부여할 수 있습니다. 다른 문서 포맷으로 변환이 쉽습니다. (워드, HTML 등)
## 2. 헤더(Header)
문서의 제목이나 소제목을 작성할 때 사용합니다. `#`의 개수에 따라 레벨이 달라집니다.
```markdown
# Heading 1
## Heading 2
### Heading 3
```
# Heading 1
## Heading 2
### Heading 3
---
## 3. 텍스트 스타일
### 3.1 **볼드(Bold)** & _이탤릭(Italic)_
```markdown
**볼드(Bold)** & _이탤릭(Italic)_
```
### 3.2 ~~취소선(Strikethrough)~~
```markdown
~~이 텍스트는 취소선이 적용됩니다.~~
```
---
## 4. 목록(List)
### 4.1 순서가 있는 목록(Ordered List)
```markdown
1. 첫번째
2. 두번째
3. 세번째
```
1. 첫번째
2. 두번째
3. 세번째
### 4.2 순서가 없는 목록(Unordered List)
```markdown
- 동그라미
- 목록
- 하위 항목
- 더 하위 항목
* 별표로도
* 가능합니다.
```
- 동그라미
- 목록
- 하위 항목
- 더 하위 항목
- 별표로도
- 가능합니다.
### 4.3 체크박스(Task List)
```markdown
- [x] 이미 완료한 항목
- [ ] 진행 중인 항목
- [ ] 해야 할 항목
```
- [x] 이미 완료한 항목
- [ ] 진행 중인 항목
- [ ] 해야 할 항목
---
## 5. 인용문(Blockquote)
`>` 기호를 사용하면 인용문을 만들 수 있습니다. 인용문 안에 헤더, 코드 블럭 등 다양한 요소를 포함할 수 있습니다.
```markdown
> 인용문은 '>'를 사용해서 작성합니다.
```
> 인용문은 '>'를 사용해서 작성합니다.
---
## 6. 코드(Code)
### 6.1 인라인 코드(Inline Code)
`` ` ``(백틱)을 사용
```markdown
이 문장 안에 `console.log("Hello World")` 처럼 작성해보세요.
```
이 문장 안에 `console.log("Hello World")` 처럼 작성해보세요.
### 6.2 코드 블록(Code Block)
- 백틱과 함께 언어를 지정하면 구문 강조(Syntax Highlighting)가 가능합니다.
````
```
\```js
console.log("Hello World");
function add(a, b) {
return a + b;
}
\```
````
```js
console.log("Hello World");
function add(a, b) {
return a + b;
}
```
---
## 7. 테이블(Table)
파이프(`|`) 기호와 `---`, `:---`, `:---:` 등을 적절히 사용해 표를 만들 수 있습니다.
정렬 기호(`:`)의 위치로 왼쪽/가운데/오른쪽 정렬을 지정합니다.
```markdown
| default | left | center | right |
| --- | :--- | :---: | ---: |
| 기본설정 | 왼쪽 정렬 | 가운데 정렬 | 오른쪽 정렬 |
| 이런식으로 | 행을 | 추가할 수 | 있다 |
```
|default|left|center|right|
|---|:--|:-:|--:|
|기본설정|왼쪽 정렬|가운데 정렬|오른쪽 정렬|
|이런식으로|행을|추가할 수|있다|
---
## 8. 링크(Links)
### 8.1 일반 링크
```markdown
[보여줄 텍스트](https://example.com)
```
[보여줄 텍스트](https://example.com/)
### 8.2 URL 자동 변환
GitHub나 일부 마크다운 에디터에서는 URL을 그냥 작성하면 자동 링크로 변환됩니다.
```
https://example.com
```
[https://example.com](https://example.com/)
### 8.3 참조 링크
긴 링크를 본문 안에 적기 번거롭다면, 아래와 같이 **참조 문법**을 사용할 수 있습니다.
```markdown
문서 작성 시 [이 곳의 예시][example] 를 참고해주세요.
[example]: https://example.com "사이트 제목"
```
문서 작성 시 [이 곳의 예시](https://example.com/ "사이트 제목") 를 참고해주세요.
---
## 9. 이미지
```markdown
```
- **장점**: 간편한 삽입
- **단점**: 스타일(크기, 여백 등) 조정 어려움, 대신 HTML을 사용해야 한다.
---
## 10. 구분선
```markdown
---
***
___
```
---
***
---
## 11. 수식
`$`로 감싸면 블록 수식을, `
로 감싸면 인라인 수식을 표시합니다.
### 11.1 블록 수식
```markdown
$
x = {-b \pm \sqrt{b^2 - 4ac} \over 2a}
$
```
$x=−b±b2−4ac2ax = {-b \pm \sqrt{b^2 - 4ac} \over 2a}$
### 11.2 인라인 수식
```markdown
여기서 $a^2 + b^2 = c^2$ 라고 할 수 있습니다.
```
여기서 $a2+b2=c2a^2 + b^2 = c^2$ 라고 할 수 있습니다.
### 11.3 아랫첨자, 윗첨자
- **윗첨자**: `^2`
- **아랫첨자**: `_{...}`
```markdown
$x^2, \quad x_{n} = x_{n-1} + n$
```
$ x2,xn=xn−1+nx^2,\quad x_{n} = x_{n-1} + n $
---
## 12. 각주(Footnotes)
```markdown
여기서[^1] 각주를 달 수 있습니다.
[^1]: 여기 있는 내용이 각주로 표시됩니다.
```
> _각주의 문법 형식은 에디터별로 상이합니다._
---
## 13. Callouts (Obsidian only)
- `[!info]` 뒤에 `+` 또는 `-`를 붙이면 접기/펼치기가 가능합니다.
- `[!info]+` : 기본적으로 펼쳐진 상태
- `[!info]-` : 기본적으로 접힌 상태
- 다른 타입: `[!warning]`, `[!question]`, `[!danger]` 등
```markdown
> [!info]
> 여기에는 정보성 메시지를 넣을 수 있습니다.
> [!tip] 제목을 지정할 수도 있어요
> 원하는 내용을 여기에 작성합니다.
> > [!faq]- 자주 묻는 질문?
> 이 콜아웃은 접힘(fold) 기능이 있어, 클릭 전에는 본문이 숨겨집니다.
```
> [!info]
> 여기에는 정보성 메시지를 넣을 수 있습니다.
> [!tip] 제목을 지정할 수도 있어요
> 원하는 내용을 여기에 작성합니다.
> [!faq]- 자주 묻는 질문?
> 이 콜아웃은 접힘(fold) 기능이 있어, 클릭 전에는 본문이 숨겨집니다.
## 14. 기타 유용한 팁
1. **TOC(Table of Contents) 자동 생성**
- 일부 마크다운 에디터나 정적 블로그 생성기(예: Hugo, Jekyll, GitBook)에서는 자동으로 목차를 만들어주는 기능을 제공합니다.
2. **수평 정렬, 중앙 정렬**
- HTML 태그 `<div align="center">` 등을 사용하거나, 테이블 정렬을 응용할 수 있습니다.
3. **PlantUML, Mermaid**
- 순서도나 다이어그램을 마크다운 안에 직접 작성 가능.
- 예) ```mermaid
- GitHub나 일부 에디터에서 미리보기도 가능합니다.
4. **확장 문법(Task list, Emoji, 수평 간격 등)**
- `- [ ]` 체크박스, `:smile:` 등의 문법은 GitHub Flavored Markdown(GFM)에서 지원합니다.
---
## 참고 문헌 & 사이트
- [CommonMark 공홈](https://commonmark.org/help/) - 표준 마크다운 가이드
- [수식 작성 가이드(TeX)](https://en.wikipedia.org/wiki/Help:Displaying_a_formula#Formatting_using_TeX)
- [Velog - 마크다운 문법 정리](https://velog.io/@seungsang00/%EB%A7%88%ED%81%AC%EB%8B%A4%EC%9A%B4-%EB%AC%B8%EB%B2%95-%EC%A0%95%EB%A6%AC)
- [Obsidian 문서(Callouts)](https://help.obsidian.md/Editing+and+formatting/Callouts)