Obsidian Markdown 치트시트

Obsidian에서 가장 자주 사용하는 Markdown 문법의 복사해서 사용할 수 있는 참조 문서로 이 페이지를 활용하세요. 표준 Markdown, 위키링크(wikilinks) 및 콜아웃(callouts)과 같은 Obsidian 확장 기능, 그리고 노트 편집 속도를 높여주는 단축키를 다룹니다.

Obsidian은 CommonMark 및 GitHub-Flavored Markdown을 기반으로 시작하여 연결된 노트를 위한 기능인 [[위키링크]], ![[임베드]], 콜아웃, 형광펜, 주석, 블록 참조 및 속성(Properties)을 추가했습니다. 표준 Markdown은 일반적으로 호환성이 더 높은 선택이며, Obsidian 전용 문법은 노트가 보관소(Vault) 내부에서 작동하도록 설계된 경우에 더 적합합니다.

빠른 참조표

필요 기능	문법	예시
제목	# ~ ######	## 프로젝트 노트
굵게	**텍스트**	**중요**
기울임꼴	*텍스트*	*선택*
취소선	~~텍스트~~	~~이전 계획~~
형광펜	==텍스트==	==결정사항==
외부 링크	[레이블](url)	[Obsidian 도움말](https://obsidian.md/help)
내부 링크	[[노트]]	[[프로젝트 기획서]]
작업	- [ ]	- [ ] 후속 조치 전송
콜아웃	> [!유형]	> [!tip] 이 워크플로우를 사용해 보세요
노트 임베드	![[노트]]	![[회의록]]
인라인 코드	`코드`	`status: draft`
주석	%%텍스트%%	%%편집 시에만 표시됨%%

텍스트 서식 및 구조

# 제목 1
## 제목 2
### 제목 3

**굵은 텍스트**
*기울임꼴 텍스트* 또는 _기울임꼴 텍스트_
***굵고 기울인 텍스트***
~~취소선 텍스트~~
==형광펜 텍스트==

> 인용구 블록에는 유용한 요약이나 미리 알림을 담을 수 있습니다.

---

새 단락을 시작하려면 빈 줄을 사용하세요. 단락 내부에서 Enter를 한 번 누르면 렌더링된 노트에서 일반적으로 소프트 줄바꿈으로 처리됩니다. 하드 줄바꿈을 적용하려면 Shift+Enter를 누르거나 Enter를 누르기 전에 공백 두 개를 추가하세요. 여러 에디터 간에 Markdown 호환 동작이 필요한 경우 설정 → 에디터 → 엄격한 줄바꿈 옵션을 확인하세요.

Markdown 문자를 그대로 표시하려면 역슬래시로 이스케이프하세요:

\*이것은 기울임꼴이 아닙니다\*
1\. 이것은 목록 항목이 아닙니다
\# 이것은 제목이 아닙니다

목록, 체크리스트 및 중첩

- 첫 번째 항목
- 두 번째 항목
  - 중첩된 항목

1. 첫 번째 단계
2. 두 번째 단계

- [ ] 열린 작업
- [x] 완료된 작업
  - [ ] 하위 작업

읽기 뷰에서는 작업 체크박스를 클릭하여 상태를 전환할 수 있습니다. 마감일, 반복 작업 및 여러 노트에 걸친 쿼리는 Obsidian 작업 관리 완벽 가이드를 참조하세요.

링크 및 임베드

내부 링크

[[노트 이름]]
[[노트 이름|표시 텍스트]]
[[노트 이름#제목]]
[[노트 이름#제목|표시 텍스트]]
[[노트 이름#^블록-ID]]

[[노트 이름]]은 보관소 내의 다른 노트로 링크됩니다. 별칭에는 |, 제목에는 #, 블록 참조에는 #^를 추가합니다. 단순 링크 대신 임베드하려면 ! 접두사를 사용하세요:

![[노트 이름]]
![[노트 이름#제목]]
![[노트 이름#^블록-ID]]
![[이미지.png]]
![[이미지.png|400]]

임베드는 재사용 가능한 정의, 회의 결정 사항 또는 체크리스트가 단일 원본 노트에서 편집 가능한 상태를 유지하면서 여러 위치에 나타나야 할 때 유용합니다.

외부 링크 및 이미지

[Obsidian 도움말](https://obsidian.md/help)
![설명](https://example.com/image.png)

설명적인 링크 텍스트를 사용하세요. 보관소를 벗어날 수 있는 노트의 경우 표준 Markdown 링크가 위키링크보다 호환성이 좋습니다.

표 (Tables)

표에는 헤더 행과 구분선 행이 필요합니다. 각 구분선 셀에는 최소 두 개의 하이픈이 필요합니다:

| 상태 | 다음 작업 |
| --- | --- |
| 진행 중 | 오늘 검토 |
| 완료 | 노트 보관 |

구분선 행에 콜론을 사용하여 열을 정렬하세요:

| 왼쪽 정렬 | 중앙 정렬 | 오른쪽 정렬 |
| :--- | :---: | ---: |
| A | B | C |

라이브 미리보기에서는 표 컨텍스트 메뉴나 표 삽입 명령을 사용하여 행과 열을 추가하세요. 표가 렌더링되지 않는 경우 다음 일반적인 원인을 확인하세요:

• 표 앞에 빈 줄을 추가하세요.
• 구분선 행을 헤더 바로 아래에 유지하세요.
• 셀 내부의 파이프 문자는 \|로 이스케이프하세요.
• 여러 줄 코드 블록은 표 셀 외부에 두세요. 예시에 두 줄 이상이 필요한 경우 링크되거나 임베드된 노트를 사용하세요.

콜아웃 (Callouts)

콜아웃은 스타일이 적용된 인용구 블록입니다. 유형 식별자가 아이콘과 색상을 제어하며, 제목은 선택 사항입니다.

> [!tip] 짧은 제목
> 조언을 설명하는 단락 가까이에 두세요.

> [!warning]- 접힌 경고
> 이 콘텐츠는 접힌 상태로 시작합니다.

일반적인 내장 유형으로는 note, abstract, info, todo, tip, success, question, warning, failure, danger, bug, example, quote가 있습니다. + 접미사는 접이식 콜아웃을 펼쳐진 상태로 시작하고, - 접미사는 접힌 상태로 시작합니다. 사용자 지정 CSS 및 문제 해결은 Obsidian 콜아웃 완벽 가이드를 참조하세요.

코드, 각주, 주석 및 수식

인라인 코드에는 단일 백틱을 사용하고 펜스 코드 블록에는 세 개의 백틱을 사용하세요. 구문 강조를 위해 언어 식별자를 추가하세요:

명령 팔레트를 열려면 `Ctrl+P`를 사용하세요.

```js
const noteType = "project";
```

각주는 참조와 정의를 사용합니다:

Obsidian은 노트를 Markdown 파일로 저장합니다.[^1]

[^1]: 현재 Obsidian 도움말 문서에서 이 동작을 확인하세요.

주석은 읽기 뷰 및 Obsidian Publish에서 숨겨집니다:

표시되는 텍스트 %%편집기 전용 메모%%

수식의 경우 인라인 수식에는 단일 달러 기호를, 블록 수식에는 이중 달러 기호를 사용하세요:

인라인: $a^2 + b^2 = c^2$

$$
\int_0^1 x^2 dx = \frac{1}{3}
$$

기억할 만한 단축키

이것들은 유용한 기본값이며 사용자 지정 단축키 설정을 대체하지는 않습니다:

작업	Windows/Linux	macOS
새 노트	Ctrl+N	Cmd+N
명령 팔레트	Ctrl+P	Cmd+P
서식 없이 붙여넣기	Ctrl+Shift+V	Cmd+Shift+V
선택 없이 현재 줄 삭제	Ctrl+Shift+K	Cmd+Shift+K
선택한 텍스트 굵게	Ctrl+B	Cmd+B
선택한 텍스트 기울임꼴	Ctrl+I	Cmd+I

Obsidian은 시스템 편집 단축키와 커스텀 명령 단축키를 분리합니다. 설정 → 단축키를 열어 템플릿 삽입, 일간 노트 열기, 플러그인 작업 실행 등의 명령을 확인하거나 변경하세요. 비 US 키보드 레이아웃에서는 표시된 키가 실제 물리적 키 레이블과 일치하지 않을 수 있습니다.

실용적인 서식 결정 표

필요 상황	추천 방식	이유
다른 Markdown 에디터와 노트 공유	표준 Markdown 링크, 제목, 목록 및 표	가장 호환성이 뛰어난 구조입니다.
하나의 보관소 내에서 노트 연결	위키링크 및 블록 참조	Obsidian이 노트 이름을 해석하고 정확한 섹션으로 링크할 수 있습니다.
체크리스트 또는 정의 재사용	임베드 (Embed)	하나의 원본 노트 업데이트로 여러 노트에 반영할 수 있습니다.
흐름을 방해하지 않고 결정 사항 설명	콜아웃 (Callout)	콘텐츠가 눈에 띄면서도 시각적으로 보조 역할을 합니다.
일간 노트를 통한 작업 추적	작업 + 일관된 템플릿	플러그인 없이도 작업 문법의 가독성이 유지됩니다.

이러한 구분은 하나의 뷰나 단일 애플리케이션에서만 작동하는 아름다운 노트를 만드는 흔한 실수를 방지해 줍니다. 호환 가능한 Markdown으로 시작한 다음, 실제 불편함을 줄여주는 위치에 Obsidian 기능을 추가하세요.

문제 해결 체크리스트

읽기 뷰에서 서식이 잘못 보이는 경우 다음 순서로 문법을 확인하세요:

1. 모든 펜스 코드 블록에 닫는 백틱이 있는지 확인합니다.
2. 새 단락, 표, 목록 또는 콜아웃 앞에 빈 줄을 추가합니다.
3. |, *, _, # 또는 백틱 문자에 이스케이프가 필요한지 확인합니다.
4. 표의 경우 구분선 행을 검증하고 셀에서 여러 줄 블록을 제거합니다.
5. 줄바꿈의 경우 Shift+Enter, 끝 부분의 공백 두 개, 또는 엄격한 줄바꿈 설정을 의도적으로 사용합니다.
6. 명령이 실행되지 않는 경우 명령 팔레트에서 검색하여 할당된 단축키를 검사합니다.

재사용 가능한 시스템에서 서식 지정은 첫 번째 레이어일 뿐입니다. 일간 노트 템플릿, 빠른 캡처 흐름, 주간 검토 및 작업 뷰는 노트를 실행하기 쉽게 만들어 줍니다. Obsibrain은 Obsidian 내부에서 이러한 계획 및 작업 관리 워크플로우를 제공합니다.

공식 참조 문서

• 기본 서식 문법
• 고급 서식 문법
• Obsidian Flavored Markdown
• 편집 단축키
• 단축키 설정
• 콜아웃 (Callouts)

Obsidian 링크 가이드, 콜아웃 가이드 또는 작업 관리를 계속해서 읽어보세요.