[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. > > 공백이 축소되는 것을 방지하거나 여러 개의 빈 공백을 추가하려면 `&nbsp;`(줄 바꿈 없는 공백) 또는 `<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 ![Engelbart](https://history-computer.com/ModernComputer/Basis/images/Engelbart.jpg) ``` ![Engelbart](https://history-computer.com/ModernComputer/Basis/images/Engelbart.jpg) 링크 대상에 `|640x480`을 추가하여 이미지 크기를 변경할 수 있어요. 여기서 640은 너비이고 480은 높이예요. ```md ![Engelbart|100x145](https://history-computer.com/ModernComputer/Basis/images/Engelbart.jpg) ``` 너비만 지정하면 이미지가 원래 종횡비에 따라 크기가 조정돼요. 예를 들어: ```md ![Engelbart|100](https://history-computer.com/ModernComputer/Basis/images/Engelbart.jpg) ``` > [!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]]을 참조하세요.