[Markdown](https://daringfireball.net/projects/markdown/)을 사용하여 노트에 기본 서식을 적용하는 방법을 알아보세요. 더 고급 서식 구문은 [[고급 서식 구문]]을 참조하세요.
## 문단
Markdown에서 문단을 만들려면 **빈 줄**을 사용하여 텍스트 블록을 구분해요. 빈 줄로 구분된 각 텍스트 블록은 별도의 문단으로 처리돼요.
```md
This is a paragraph.
This is another paragraph.
```
This is a paragraph.
This is another paragraph.
텍스트 줄 사이에 빈 줄을 넣으면 별도의 문단이 생성돼요. 이것은 Markdown의 기본 동작이에요.
> [!tip]- 여러 개의 공백
> 문단 내부와 문단 사이의 여러 개의 인접한 공백은 [[뷰와 편집 모드#읽기 보기|읽기 보기]]나 [[Obsidian Publish 소개|Obsidian Publish]] 사이트에서 표시될 때 하나의 공백으로 축소돼요.
>
> ```md
> Multiple adjacent spaces
>
>
>
> and multiple newlines between paragraphs.
> ```
>
> > Multiple adjacent spaces
> >
> >
> >
> > and multiple newlines between paragraphs.
>
> 공백이 축소되는 것을 방지하거나 여러 개의 빈 공백을 추가하려면 ` `(줄 바꿈 없는 공백) 또는 `<br>`(줄 바꿈) HTML 태그를 사용할 수 있어요.
### 줄 바꿈
Obsidian에서는 기본적으로 `Enter`를 한 번 누르면 노트에 새 줄이 생성되지만, 일반적인 Markdown 동작에 따라 렌더링된 출력에서는 같은 문단의 *연속*으로 처리돼요. 새 문단을 시작하지 않고 문단 *내에서* 줄 바꿈을 삽입하려면 다음 중 하나를 수행할 수 있어요:
- `Enter`를 누르기 전에 줄 끝에 **두 개의 공백**을 추가하거나,
- `Shift+Enter` 단축키를 사용하여 직접 줄 바꿈을 삽입해요.
> [!question]- 읽기 보기에서 여러 번 `Enter`를 눌러도 왜 줄 바꿈이 더 생기지 않나요?
> Markdown에서 단일 `Enter`는 무시되며, 연속적으로 여러 번 `Enter`를 누르면 하나의 새 문단만 생성돼요. 이 동작은 Markdown의 소프트 줄 바꿈 규칙에 따른 것으로, 추가 빈 줄은 추가적인 줄 바꿈이나 문단을 생성하지 않으며 하나의 문단 구분으로 축소돼요. 이것은 Markdown이 텍스트를 처리하는 기본 방식으로, 예상치 못한 줄 바꿈 없이 문단이 자연스럽게 흐르도록 해요.
Obsidian에는 **[[설정#엄격한 줄 바꿈|엄격한 줄 바꿈]]** 설정이 포함되어 있어, Obsidian이 줄 바꿈에 대한 표준 Markdown 사양을 따르도록 해요.
이 기능을 활성화하려면:
1. **[[설정]]**을 열어요.
2. **편집기** 탭으로 이동해요.
3. **엄격한 줄 바꿈**을 활성화해요.
Obsidian에서 **엄격한 줄 바꿈**이 활성화되면, 줄이 구분되는 방식에 따라 세 가지 다른 동작이 있어요:
**공백 없이 단일 줄 바꿈**: 후행 공백 없이 `Enter`를 한 번 누르면 두 개의 별도 줄이 렌더링 시 하나의 줄로 결합돼요.
```md
line one
line two
```
다음과 같이 렌더링돼요:
line one line two
**두 개 이상의 후행 공백이 있는 단일 줄 바꿈**: 첫 번째 줄 끝에 `Enter`를 누르기 전에 두 개 이상의 공백을 추가하면, 두 줄은 같은 문단의 일부로 유지되지만 줄 바꿈(HTML `<br>` 요소)으로 구분돼요. 이 예시에서는 공백을 두 개의 밑줄로 대체해요.
```md
line three__
line four
```
다음과 같이 렌더링돼요:
line three<br>
line four
**이중 줄 바꿈(후행 공백 유무에 관계없이)**: `Enter`를 두 번 이상 누르면 첫 번째 줄 끝에 공백을 추가했는지 여부에 관계없이 줄이 두 개의 별도 문단(HTML `<p>` 요소)으로 분리돼요.
```md
line five
line six
```
다음과 같이 렌더링돼요:
<p>line five</p>
<p>line six</p>
## 제목
제목을 만들려면 제목 텍스트 앞에 최대 6개의 `#` 기호를 추가해요. `#` 기호의 수가 제목의 수준을 설정해요([[개요]]에 표시됨).
```md
# This is a heading 1
## This is a heading 2
### This is a heading 3
#### This is a heading 4
##### This is a heading 5
###### This is a heading 6
```
%% These headings use HTML to avoid cluttering the Outline/Table of contents %%
<h1>제목 1이에요</h1>
<h2>제목 2예요</h2>
<h3>제목 3이에요</h3>
<h4>제목 4예요</h4>
<h5>제목 5예요</h5>
<h6>제목 6이에요</h6>
## 굵게, 기울임꼴, 강조 표시
텍스트 서식은 [[편집 단축키]]를 사용하여 적용할 수도 있어요.
| 스타일 | 구문 | 예시 | 출력 |
|-|-|-|-|
| 굵게 | `** **` 또는 `__ __` | `**Bold text**` | **Bold text** |
| 기울임꼴 | `* *` 또는 `_ _` | `*Italic text*` | *Italic text* |
| 취소선 | `~~ ~~` | `~~Striked out text~~` | ~~Striked out text~~ |
| 강조 표시 | `== ==` | `==Highlighted text==` | ==Highlighted text== |
| 굵게 및 중첩 기울임꼴 | `** **` 및 `_ _` | `**Bold text and _nested italic_ text**` | **Bold text and _nested italic_ text** |
| 굵게 및 기울임꼴 | `*** ***` 또는 `___ ___` | `***Bold and italic text***` | ***Bold and italic text*** |
서식 앞에 백슬래시 `\`를 추가하면 일반 텍스트로 표시하도록 강제할 수 있어요.
\*\*This line will not be bold\*\*
```markdown
\*\*This line will not be bold\*\*
```
\**This line will be italic and show the asterisks*\*
```markdown
\**This line will be italic and show the asterisks*\*
```
## 내부 링크
Obsidian은 노트 간 [[내부 링크]]를 위해 두 가지 형식을 지원해요:
- 위키 링크: `[[Three laws of motion]]`
- Markdown: `[Three laws of motion](Three%20laws%20of%20motion.md)`
## 외부 링크
외부 URL로 링크하려면 링크 텍스트를 대괄호(`[ ]`)로 감싼 다음 URL을 소괄호(`( )`)로 감싸서 인라인 링크를 만들 수 있어요.
```md
[Obsidian Help](https://help.obsidian.md)
```
[Obsidian Help](https://help.obsidian.md)
[[Obsidian URI|Obsidian URI]]로 링크하여 다른 보관함의 파일에 대한 외부 링크도 만들 수 있어요.
```md
[Note](obsidian://open?vault=MainVault&file=Note.md)
```
### 링크에서 공백 이스케이프
URL에 공백이 포함된 경우 `%20`으로 대체하여 이스케이프해야 해요.
```md
[My Note](obsidian://open?vault=MainVault&file=My%20Note.md)
```
URL을 꺾쇠괄호(`< >`)로 감싸서 이스케이프할 수도 있어요.
```md
[My Note](<obsidian://open?vault=MainVault&file=My Note.md>)
```
## 외부 이미지
[[#외부 링크|외부 링크]] 앞에 `!` 기호를 추가하여 외부 URL의 이미지를 추가할 수 있어요.
```md

```

링크 대상에 `|640x480`을 추가하여 이미지 크기를 변경할 수 있어요. 여기서 640은 너비이고 480은 높이예요.
```md

```
너비만 지정하면 이미지가 원래 종횡비에 따라 크기가 조정돼요. 예를 들어:
```md

```
> [!tip]- 팁
> 보관함 내부의 이미지를 추가하려면 [[파일 임베드#노트에 이미지 임베드|노트에 이미지 임베드]]를 할 수도 있어요.
## 인용
텍스트 앞에 `>` 기호를 추가하여 텍스트를 인용할 수 있어요.
```md
> Human beings face ever more complex and urgent problems, and their effectiveness in dealing with these problems is a matter that is critical to the stability and continued progress of society.
\- Doug Engelbart, 1961
```
> Human beings face ever more complex and urgent problems, and their effectiveness in dealing with these problems is a matter that is critical to the stability and continued progress of society.
\- Doug Engelbart, 1961
> [!tip]- 팁
> 인용의 첫 번째 줄에 `[!info]`를 추가하여 인용을 [[콜아웃|콜아웃]]으로 변환할 수 있어요.
## 목록
`-`, `*`, 또는 `+`를 텍스트 앞에 추가하여 순서 없는 목록을 만들 수 있어요.
```md
- First list item
- Second list item
- Third list item
```
- First list item
- Second list item
- Third list item
순서 있는 목록을 만들려면 각 줄의 시작에 숫자 뒤에 `.` 또는 `)` 기호를 붙여요.
```md
1. First list item
2. Second list item
3. Third list item
```
1. First list item
2. Second list item
3. Third list item
```md
1) First list item
2) Second list item
3) Third list item
```
1) First list item
2) Second list item
3) Third list item
`Shift+Enter`를 사용하여 순서 있는 목록의 번호를 변경하지 않고 [[#줄 바꿈|줄 바꿈]]을 삽입할 수 있어요.
```md
1. First list item
2. Second list item
3. Third list item
4. Fourth list item
5. Fifth list item
6. Sixth list item
```
### 작업 목록
작업 목록을 만들려면 각 목록 항목을 하이픈과 공백 다음에 `[ ]`로 시작해요.
```md
- [x] This is a completed task.
- [ ] This is an incomplete task.
```
- [x] This is a completed task.
- [ ] This is an incomplete task.
읽기 보기에서 체크박스를 선택하여 작업을 전환할 수 있어요.
> [!tip]- 팁
> 대괄호 안에 어떤 문자든 사용하여 완료로 표시할 수 있어요.
>
> ```md
> - [x] Milk
> - [?] Eggs
> - [-] Eggs
> ```
>
> - [x] Milk
> - [?] Eggs
> - [-] Eggs
### 목록 중첩
순서 있는 목록, 순서 없는 목록, 작업 목록 등 모든 유형의 목록을 다른 유형의 목록 아래에 중첩할 수 있어요.
중첩된 목록을 만들려면 하나 이상의 목록 항목을 들여쓰기해요. 중첩 구조 내에서 목록 유형을 혼합할 수 있어요:
```md
1. First list item
1. Ordered nested list item
2. Second list item
- Unordered nested list item
```
1. First list item
1. Ordered nested list item
2. Second list item
- Unordered nested list item
마찬가지로, 하나 이상의 목록 항목을 들여쓰기하여 중첩된 작업 목록을 만들 수 있어요:
```md
- [ ] Task item 1
- [ ] Subtask 1
- [ ] Task item 2
- [ ] Subtask 1
```
- [ ] Task item 1
- [ ] Subtask 1
- [ ] Task item 2
- [ ] Subtask 1
`Tab` 또는 `Shift+Tab`을 사용하여 선택한 목록 항목을 들여쓰기하거나 내어쓰기하여 쉽게 정리할 수 있어요.
## 수평선
별표 세 개 이상 `***`, 하이픈 `---`, 또는 밑줄 `___`을 별도의 줄에 사용하여 수평선을 추가할 수 있어요. 기호 사이에 공백을 넣어 구분할 수도 있어요.
```md
***
****
* * *
---
----
- - -
___
____
_ _ _
```
***
## 코드
문장 내에서 인라인으로 코드 서식을 지정하거나 자체 블록으로 서식을 지정할 수 있어요.
### 인라인 코드
단일 백틱을 사용하여 문장 내에서 코드 서식을 지정할 수 있어요.
```md
Text inside `backticks` on a line will be formatted like code.
```
Text inside `backticks` on a line will be formatted like code.
인라인 코드 블록에 백틱을 넣으려면 다음과 같이 이중 백틱으로 감싸세요: inline ``code with a backtick ` inside``.
### 코드 블록
코드를 블록으로 서식 지정하려면 세 개 이상의 백틱 또는 세 개 이상의 물결표로 감싸요.
~~~
`````
cd ~/Desktop
`````
~~~
`````
~~~
cd ~/Desktop
~~~
`````
`````md
cd ~/Desktop
`````
`Tab` 또는 4개의 공백을 사용하여 텍스트를 들여쓰기하여 코드 블록을 만들 수도 있어요.
`````md
cd ~/Desktop
`````
첫 번째 백틱 세트 뒤에 언어 코드를 추가하여 코드 블록에 구문 강조를 추가할 수 있어요.
~~~md
`````js
function fancyAlert(arg) {
if(arg) {
$.facebox({div:'#foo'})
}
}
`````
~~~
`````js
function fancyAlert(arg) {
if(arg) {
$.facebox({div:'#foo'})
}
}
`````
Obsidian은 구문 강조를 위해 Prism을 사용해요. 자세한 정보는 [지원 언어](https://prismjs.com/#supported-languages)를 참조하세요.
> [!info]+ PrismJS와 편집 뷰
> [[뷰와 편집 모드#원본 모드|원본 모드]]와 [[뷰와 편집 모드#실시간 미리보기|실시간 미리보기]]는 PrismJS를 지원하지 않으며 구문 강조를 다르게 렌더링할 수 있어요.
#### 코드 블록 중첩
다른 코드 블록 안에 코드 블록을 포함해야 할 때(예: 코드 블록 사용법을 문서화할 때), 외부 코드 블록에 세 개 이상의 백틱 또는 물결표를 사용할 수 있어요.
코드 블록을 중첩하려면 외부 블록에 네 개 이상의 백틱(또는 물결표)을 사용하고 내부 블록에는 세 개를 사용해요:
`````md
````md
Here's how to create a code block:
```js
console.log("Hello world")
```
````
`````
백틱과 물결표를 혼합할 수도 있어요. 이는 다른 코드 블록을 생성하는 코드를 작업할 때 특히 유용해요:
`````md
````md
```dataviewjs
dv.paragraph(`
~~~mermaid
graph TD
A --> B
~~~
`)
```
````
`````
핵심 원칙은 외부 코드 블록이 내부 코드 블록보다 **더 많은** 펜스 문자(백틱 또는 물결표)를 사용하거나 다른 펜스 문자 유형을 사용해야 한다는 거예요.
## 각주
다음 구문을 사용하여 노트에 각주[^footnote]를 추가할 수 있어요:
[^footnote]: 이것은 각주예요.
```md
This is a simple footnote[^1].
[^1]: This is the referenced text.
[^2]: Add 2 spaces at the start of each new line.
This lets you write footnotes that span multiple lines.
[^note]: Named footnotes still appear as numbers, but can make it easier to identify and link references.
```
문장 내에서 인라인 각주를 사용할 수도 있어요. 캐럿이 대괄호 바깥에 위치하는 점에 유의하세요.
```md
You can also use inline footnotes. ^[This is an inline footnote.]
```
> [!note] 참고
> 인라인 각주는 읽기 보기에서만 작동하며 실시간 미리보기에서는 작동하지 않아요.
[[각주 보기]]를 사용하여 노트의 모든 각주를 확인할 수 있어요.
## 주석
`%%`로 텍스트를 감싸서 주석을 추가할 수 있어요. 주석은 편집 뷰에서만 보여요.
```md
This is an %%inline%% comment.
%%
This is a block comment.
Block comments can span multiple lines.
%%
```
## Markdown 구문 이스케이프
경우에 따라 `*`, `_`, `#`과 같은 특수 문자를 서식을 트리거하지 않고 Markdown에 표시해야 할 수 있어요. 이러한 문자를 그대로 표시하려면 앞에 백슬래시(`\`)를 놓으세요.
> [!example] 이스케이프할 일반적인 문자
>
> - 별표: `\*`
> - 밑줄: `\_`
> - 해시태그: `\#`
> - 백틱: `` \` ``
> - 파이프(표에서 사용): `\|`
> - 물결표: `\~`
```md
\*This text will not be italicized\*.
```
\*This text will not be italicized\*.
번호 매기기 목록으로 작업할 때 자동 목록 서식을 방지하기 위해 숫자 뒤의 마침표를 이스케이프해야 할 수 있어요. 백슬래시(`\`)를 숫자 앞이 **아닌** 마침표 앞에 놓으세요.
```md
1\. This won't be a list item.
```
1\. This won't be a list item.
## 자세히 알아보기
표, 다이어그램, 수학 표현식과 같은 더 고급 서식 구문을 알아보려면 [[고급 서식 구문]]을 참조하세요.
Obsidian이 Markdown을 파싱하는 방법에 대해 자세히 알아보려면 [[Obsidian 스타일 Markdown]]을 참조하세요.