2026년 8월 29일 업데이트: 옵시디언 1.13.7과 공식 마크다운 문법 안내를 기준으로 빠른 문법표, 주석·이스케이프, 중첩 체크박스, 접이식 콜아웃, Properties·Mermaid·수식을 보강했습니다.
옵시디언은 마크다운 문법으로 문서를 작성합니다. 이 글은 제목·링크 같은 공통 문법과 체크박스·각주·콜아웃 같은 옵시디언 전용 문법을 정리한 치트시트입니다. 표 생성·열 정렬·Bases는 옵시디언 표 만들기 가이드에서 별도로 다룹니다.
옵시디언 마크다운 빠른 문법 요약
자주 쓰는 문법만 먼저 찾는다면 위 표를 사용하고, 실제 입력 예제와 결과가 필요하면 아래 항목을 순서대로 확인하세요.
아래 목차를 이용하시면 원하는 마크다운 문법으로 빠르게 이동가능합니다. 또한, PC의 경우 오른쪽 하단에 뜨는 위로가기 화살표를 이용하시면, 다시 목차로 돌아오실 수 있습니다.
일반적인 마크다운 문법 정리
마크다운은 여러가지 버전이 존재합니다. 그 중 일반적으로 많이 사용하는 마크다운과 옵시디언에서만 작동하는 옵시디언 전용 마크다운이 존재하는데요, 먼저 일반적인 마크다운 문법 정리를 해보겠습니다.
1. 제목(Headers)
제목을 만들 때는 #을 사용하며, #의 개수에 따라 제목의 수준이 달라집니다.
# 제목 1 (가장 큰 제목)
## 제목 2
### 제목 3
#### 제목 4- 결과
2. 굵게(Bold)
텍스트를 굵게 표시하려면 **굵게** 또는 __굵게__를 사용하여 텍스트를 감싸면 됩니다.
**굵은 텍스트**
__굵은 텍스트__- 결과
굵은 텍스트
굵은 텍스트
3. 기울임, 이탤릭(Italic)
텍스트를 기울임 (이탤릭) 체로 표시하려면 * 또는 _로 텍스트를 감싸면 됩니다. 앞에서 굵게 하기 위해서는 2개, 기울이는 것은 1개만 사용하는것이 차이점입니다.
*이탤릭 텍스트*
_기울임 텍스트_- 결과
이탤릭 텍스트
기울임 텍스트
4. 취소선(Strikethrough)
텍스트에 취소선을 추가하려면 ~~로 텍스트를 감싸면 됩니다.
~~취소선 텍스트~~
- 결과
취소선 텍스트
5. 리스트(Lists)
순서가 있는 리스트와 순서가 없는 리스트를 작성할 수 있습니다.
순서가 있는 리스트
숫자와 점을 사용하여 순서가 있는 리스트를 작성할 수 있습니다.
1. 항목 1
2. 항목 2
3. 항목 3
- 결과
순서가 없는 리스트
-, +, *를 사용하여 순서가 없는 리스트를 작성할 수 있습니다.
- 항목 1
- 항목 2
- 항목 3
- 결과
6. 링크(Links)
링크를 삽입하려면 [링크 텍스트](URL) 형식을 사용합니다. 결과 링크의 맨 오른쪽에 붙은 아이콘이 현재 옵시디언 바깥으로 나가는 링크가 삽입되어있다는 의미를 나타냅니다.
[슬기로운 통계생활](https://statisticsplaybook.com/)- 결과
7. 이미지(Images)
이미지를 삽입하려면  형식을 사용합니다.
- 결과
8. 인용구(Blockquotes)
인용구를 만들려면 >를 사용합니다. 또한 백슬래쉬 (\) 을 사용하면 마크다운 문법에 사용되는 기호들을 사용할 수 있는데요, 아래 예제에서는 리스트를 만드는 - 기호를 백슬래쉬 기호를 사용하여 삽입 한 것을 볼 수 있습니다.
> Anyone can learn anything with a proper education.
\- Issac Lee, 2023- 결과
9. 코드(Code)
인라인 코드는 `backticks`로 감싸고, 코드 블록은 세 개의 `backticks`로 감싸서 작성합니다.
인라인 코드: `print("Hello, World!")`
코드 블록:
```
def greet():
print("Hello, World!")
```
- 결과
10. 수평선(Horizontal Rule)
수평선을 추가하려면 ---, ___, 또는 ***을 사용합니다.
---
***
___
- 결과
11. 각주(Footnotes)
각주를 노트에 추가하는 방법은 아래와 같습니다.
기본 각주 문법
문장에 각주를 추가하려면 [^1]와 같은 방식으로 텍스트에 각주를 표시하고, 페이지 하단에 해당 각주에 대한 설명을 작성할 수 있습니다.
이것은 간단한 각주[^1]입니다.
[^1]: 이것은 참조된 텍스트입니다.
- 결과
여러 줄의 각주 작성
각주가 여러 줄에 걸쳐 작성되어야 하는 경우 각 새 줄 앞에 2개의 공백을 추가합니다.
이것은 각주가 여러줄로 달리는 경우[^2]입니다.
[^2]: 각주의 첫 줄입니다.
이것은 각주가 여러 줄에 걸쳐 작성될 때 사용하는 방법입니다.
- 결과
이름이 지정된 각주
각주에 이름을 지정하여 각주를 더 쉽게 식별하고 참조를 연결할 수 있습니다. 이름이 지정된 각주도 번호로 표시됩니다.
이것은 이름이 지정된 각주[^note]입니다.
[^note]: 이름이 지정된 각주는 여전히 숫자로 표시되지만, 참조를 더 쉽게 식별하고 연결할 수 있게 해줍니다.
- 결과
문장 안 각주 넣기
각주를 문장 안에 인라인으로 추가할 수도 있습니다. 이 경우, ^기호가 대괄호 바깥쪽에 위치합니다.
인라인 각주도 사용할 수 있습니다. ^[이것은 인라인 각주입니다.]
- 결과
12. 주석과 특수문자 이스케이프
편집 화면에만 남기고 읽기 화면에서는 숨기고 싶은 메모는 %% 주석 %%으로 감쌉니다. 여러 줄 주석도 시작과 끝을 %%로 감싸면 됩니다.
마크다운 기호를 서식이 아니라 문자 자체로 보여주려면 앞에 역슬래시(\)를 붙입니다. 특히 표 안에서 내부 링크 별칭이나 이미지 크기의 세로선은 \|로 입력해야 열 구분자로 오해하지 않습니다.
위의 내용들은 가장 기본적인 마크다운 문법입니다. 옵시디언은 다음과 같은 다양한 마크다운 확장 기능도 지원합니다.
옵시디언 전용 마크다운 문법 정리
앞에서 일반적인 마크다운 문법 정리를 해보았다면, 이제부터는 옵시디언에서만 사용가능한 마크다운 문법 정리를 해보도록 하겠습니다.
1. 하이라이트 (Highlight)
일반 마크다운에는 텍스트 하이라이트 문법이 정해져 있지 않지만, 옵시디언에서는 텍스트 앞뒤를 ==로 감싸 하이라이트할 수 있습니다.
==하이라이트 텍스트==
- 결과
2. 체크박스 (check box)
마크다운으로 체크 박스나 체크 리스트를 삽입하려면 각 목록 항목을 하이픈(-)과 공백 뒤에 [ ]로 시작하시면 됩니다. 공백 안에 x 표시를 할 경우, 목록에 취소선이 생기게 됩니다. 공백 안을 다른 문자로 채우게 되면, 완료 표시로 바뀌게 됩니다.
### 해야 할 일들
- [x] 화분 물 주기
- [-] 우편함 확인
- [ ] 밀린 일기 작성
- [x] 사진 정리
- [ ] 오늘 내용 작성하위 작업은 앞에 공백을 넣어 들여씁니다. 선택한 항목에서 Tab을 누르면 하위 체크박스로, Shift+Tab을 누르면 상위 단계로 이동할 수 있습니다.
- 결과
참고: 옵시디언 체크박스 단축키
옵시디언에서는 체크 박스를 쉽게 만들 수 있도록 단축키가 기본으로 제공됩니다. 체크박스를 만들기 원하는 행에 커서를 놓고 Ctrl + L 단축키를 누르게 되면 자동으로 체크 박스로 변하게 됩니다.
3. 그림 크기(Images size)
앞에서 설명한 일반적인 마크다운 이미지 삽입 코드에 옵시디언에서만 작동하는 이미지 크기를 조절하는 옵션이 존재합니다.  형식을 사용합니다.
- 결과
4. 문서 링크 (Internal Links)
내부 링크는 노트 간 또는 블록 간에 서로 연결되는 링크입니다. [[]] 안에 페이지 이름을 넣어서 생성할 수 있습니다. 이를 통해 빠르게 관련 정보로 이동할 수 있습니다. 예를 들어, Vault 안에 “옵시디언 사용법”이라는 노트가 있는 경우, 다음과 같이 작성하면, 옵시디언 사용법 노트로 가는 링크가 생성됩니다.
[[옵시디언 사용법]]- 결과
5. 문서 임베딩 (Embedding Links)
내부 링크와는 다르게 노트 내용 자체를 다른 노트에 박아놓을 때 사용하는 마크다운 문법입니다. 알고 있는면 상당히 유용합니다. 아래 결과를 보면 현재 노트에 다른 노트가 임베딩 되어 있다는 표시가 되어 있는 것을 확인 할 수 있습니다.
![[옵시디언 사용법]]- 결과
6. 문단 참조(Block Reference)
블록 참조는 다른 블록 내용을 현재 블록에 포함시키는 기능입니다. ![[블록 링크#^id]] 형식으로 사용합니다.
![[옵시디언 사용법#^myobsi]]- 결과
위와 같이 ID를 부여한 문단 만 임베딩 된 것을 확인 할 수 있습니다.
7. 강조 상자 넣기 (Callout, 말풍선)
내용을 쓰다가 강조하는 부분이 있다거나, 정리를 할 때 유용한 문법입니다.
> [!note] 이것만 알아두세요!
> 옵시디언은 정말 편한 도구입니다.
> [!faq]- 눌러서 답 보기
> 마이너스(-)는 기본 접힘, 플러스(+)는 기본 펼침입니다.
콜아웃 유형 바로 뒤에 -를 붙이면 기본적으로 접힌 상태, +를 붙이면 기본적으로 펼쳐진 상태가 됩니다. 제목을 클릭하면 내용을 접거나 펼칠 수 있습니다.
Callout 지원리스트
Callout 문법이 좋은 이유는 위의 문법에서 [!note] 부분을 다음과 같은 키워드로 바꿔주면 알맞은 아이콘에 색상이 다른 Callout 상자가 생성된다는 것입니다. 한번씩 시도해보세요! (같은 줄에 있는 단어들은 같은 아이콘 유사어들입니다.)
- [!note]
- [!abstract], [!summary], [!tldr]
- [!info]
- [!todo]
- [!tip], [!hint], [!important]
- [!success], [!check], [!done]
- [!question], [!help], [!faq]
- [!warning], [!caution], [!attention]
- [!failure], [!fail], [!missing]
- [!danger], [!error]
- [!bug]
- [!example]
- [!quote], [!cite]
다음 단계: Properties·Mermaid·수식
기본 문법에 익숙해졌다면 다음 세 기능으로 노트를 구조화하거나 시각화할 수 있습니다.
Properties로 노트 정보 구조화하기
노트 맨 위에서 ---를 입력하거나 Ctrl/Cmd + ;을 누르면 Properties를 추가할 수 있습니다. 예를 들어 status: 진행중, due: 2026-08-31, favorite: true처럼 텍스트·날짜·체크박스 값을 저장합니다. 같은 이름의 Property는 vault 전체에서 같은 자료형을 사용하므로 이름을 일관되게 정하는 것이 좋습니다.
Mermaid로 흐름도 그리기
코드 펜스의 언어를 mermaid로 지정하고 안에 graph TD; A[아이디어] --> B[작성] --> C[검토]를 입력하면 흐름도로 렌더링됩니다. 순서도뿐 아니라 시퀀스 다이어그램과 타임라인도 만들 수 있습니다.
MathJax로 수식 작성하기
문장 안의 수식은 한 쌍의 달러 기호로 감싸고, 독립된 수식은 두 쌍의 달러 기호로 감쌉니다. 예를 들어 인라인 수식은 $e^{i\pi}+1=0$, 별도 수식 블록은 $$E=mc^2$$처럼 작성합니다.
옵시디언 가이드 모음
당신이 좋아할 만한 콘텐츠
by Google Adsense
