옵시디언 마크다운 가이드

2025. 12. 12. 10:36·사용 툴 및 개인설정

기본 마크다운 문법

제목 (Headers)

# H1 제목
## H2 제목
### H3 제목
#### H4 제목
##### H5 제목
###### H6 제목

텍스트 강조

*기울임체* 또는 _기울임체_
**굵은 글씨** 또는 __굵은 글씨__
***굵은 기울임체*** 또는 ___굵은 기울임체___
~~취소선~~
==형광펜==

결과:

  • 기울임체
  • 굵은 글씨
  • 굵은 기울임체
  • 취소선
  • ==형광펜==

리스트

순서 없는 리스트:

- 항목 1
- 항목 2
  - 하위 항목 2.1
  - 하위 항목 2.2
- 항목 3

순서 있는 리스트:

1. 첫 번째
2. 두 번째
3. 세 번째

체크박스:

- [ ] 할 일 1
- [x] 완료된 일
- [ ] 할 일 2

인용구

> 이것은 인용구입니다.
> 여러 줄로 작성할 수 있습니다.
>
> > 중첩된 인용구도 가능합니다.

코드

인라인 코드:

`console.log('Hello World')`

코드 블록:

```javascript
function hello() {
  console.log('Hello World');
}
```

가로줄 (수평선)

세 가지 방식 모두 같은 결과를 만듭니다:

---
***
___

결과: 페이지에 가로로 긴 선이 그어집니다.

사용 팁:

  • 섹션을 구분할 때 사용
  • 최소 3개 이상의 기호 필요
  • 기호 사이에 공백이 있어도 됨: - - -, * * *

옵시디언 특화 문법

내부 링크 (Wikilinks)

기본 링크:

[[노트 이름]]

별칭을 사용한 링크:

[[실제 노트 이름|표시될 텍스트]]

헤딩으로 링크:

[[노트 이름#헤딩 제목]]

블록으로 링크:

[[노트 이름#^블록ID]]

임베딩 (Embedding)

노트 임베드:

![[노트 이름]]

특정 헤딩 임베드:

![[노트 이름#헤딩]]

이미지 임베드:

![[이미지.png]]
![[이미지.png|200]]  // 너비 지정
![[이미지.png|200x100]]  // 너비x높이 지정

PDF 임베드:

![[문서.pdf]]
![[문서.pdf#page=5]]  // 특정 페이지

태그 (Tags)

#태그
#계층적/태그/구조
#태그-이름-with-dashes

인라인 태그:

이 문장에는 #태그 가 포함되어 있습니다.

YAML 프론트매터의 태그:

---
tags:
  - 태그1
  - 태그2
  - 계층적/태그
---

주석 (Comments)

%% 이것은 주석입니다. 프리뷰나 퍼블리시에서 보이지 않습니다. %%

%%
여러 줄
주석도
가능합니다
%%

링크와 임베딩

외부 링크

기본 형식:

[링크 텍스트](https://example.com)

툴팁 추가:

[링크 텍스트](https://example.com "툴팁 텍스트")

자동 링크:

<https://example.com>

이미지

기본 이미지:

![대체 텍스트](이미지경로.png)

옵시디언 방식:

![[이미지.png]]
![[이미지.png|대체 텍스트]]
![[이미지.png|300]]

각주 (Footnotes)

이것은 각주가 있는 문장입니다[^1].

다른 각주도 추가할 수 있습니다[^note].

[^1]: 이것은 첫 번째 각주입니다.
[^note]: 이름이 있는 각주입니다.

고급 기능

콜아웃 (Callouts)

옵시디언은 다양한 스타일의 콜아웃을 지원합니다:

> [!note]
> 노트 형식의 콜아웃입니다.

> [!tip]
> 팁 콜아웃입니다.

> [!warning]
> 경고 콜아웃입니다.

> [!danger]
> 위험 콜아웃입니다.

> [!info]
> 정보 콜아웃입니다.

> [!quote]
> 인용 콜아웃입니다.

접을 수 있는 콜아웃:

> [!faq]- 질문과 답변
> 기본적으로 접혀있습니다. `-`를 사용했습니다.

> [!tip]+ 펼쳐진 팁
> `+`를 사용하면 기본적으로 펼쳐져 있습니다.

사용 가능한 콜아웃 타입:

  • note, tip, warning, danger, error
  • info, todo, success, question, faq
  • abstract, summary, tldr
  • quote, cite
  • bug, example

표 (Tables)

| 헤더1 | 헤더2 | 헤더3 |
|-------|-------|-------|
| 셀1   | 셀2   | 셀3   |
| 셀4   | 셀5   | 셀6   |

정렬:

| 왼쪽 정렬 | 중앙 정렬 | 오른쪽 정렬 |
|:----------|:---------:|------------:|
| 텍스트    | 텍스트    | 텍스트      |

다이어그램 (Mermaid)

```mermaid
graph TD
    A[시작] --> B{결정}
    B -->|예| C[결과1]
    B -->|아니오| D[결과2]
```

시퀀스 다이어그램:

```mermaid
sequenceDiagram
    Alice->>Bob: 안녕하세요!
    Bob->>Alice: 안녕하세요!
```

수식 (Math)

인라인 수식:

$E = mc^2$

블록 수식:

$$
\begin{equation}
\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
\end{equation}
$$

YAML 프론트매터

노트의 메타데이터를 정의할 수 있습니다:

---
title: 노트 제목
author: 작성자
date: 2024-01-01
tags:
  - 태그1
  - 태그2
aliases:
  - 별칭1
  - 별칭2
cssclass: custom-class
---

데이터뷰 (Dataview Plugin)

Dataview 플러그인을 설치하면 강력한 쿼리 기능을 사용할 수 있습니다:

```dataview
LIST
FROM #프로젝트
WHERE status = "진행중"
SORT date DESC
```
```dataview
TABLE author, date, rating
FROM #책
SORT rating DESC
```

실무 팁

1. 링크 관리

  • [[]] 를 사용하여 내부 링크를 만들면 파일명이 변경되어도 자동으로 업데이트됩니다
  • 백링크(Backlinks) 기능으로 연결된 노트를 추적할 수 있습니다

2. 템플릿 활용

---
created: {{date}}
tags: #템플릿
---

# {{title}}

## 개요

## 내용

## 참고자료

3. 빠른 노트 작성

  • Ctrl/Cmd + N: 새 노트
  • Ctrl/Cmd + O: 빠른 전환
  • Ctrl/Cmd + P: 명령 팔레트

4. 효율적인 태그 사용

#프로젝트/개발/백엔드
#상태/진행중
#우선순위/높음

5. 블록 참조 활용

중요한 문장입니다. ^important-quote

다른 노트에서 참조: ![[현재노트#^important-quote]]

마무리

옵시디언의 마크다운은 표준 마크다운 문법을 기반으로 하면서도, 개인 지식 관리(PKM)에 특화된 강력한 기능들을 제공합니다.

핵심 기능:

  • 양방향 링크로 아이디어 연결
  • 임베딩으로 정보 통합
  • 태그와 프론트매터로 분류 및 관리
  • 플러그인으로 무한한 확장성

위의 문법들을 익혀서 여러분만의 제2의 뇌(Second Brain)를 만들어보세요!


참고 자료:

  • Obsidian 공식 문서
  • Markdown Guide
  • Obsidian Forum
'사용 툴 및 개인설정' 카테고리의 다른 글
  • Mermaid - 코드로 시퀀스 다이어그램 동적으로 만들기
  • DBeaver / SQL 자동완성 대문자 변환 / 자주 쓰는 단축키 / 데이터 엑셀로 추출(한글깨짐해결)
Du^
Du^
  • Du^
    DD
    Du^
  • 전체
    오늘
    어제
    • 분류 전체보기 (17)
      • 💡주제별 (3)
        • Front (0)
        • AWS (0)
        • 도커 (2)
        • AI (1)
      • 💡총정리 (0)
        • 1. 서버 엔지니어링 (0)
        • 2. 데이터베이스 (0)
        • 3. 테스트 전략 (0)
        • 4. 애플리케이션 설계 (0)
        • 5. 성능 엔지니어링 (0)
      • Spring (3)
      • Git (1)
      • 디자인패턴 (0)
      • Cafe24 (0)
      • 운영체제 (1)
      • 온라인 강의 (0)
        • 클린 코더스 강의 (0)
      • 오프라인 강의 (0)
        • AWS (0)
      • 개발도서 (1)
        • DB (1)
      • 사용 툴 및 개인설정 (3)
      • AI가 만들어준 가이드 (4)
      • 프로젝트 (0)
  • 블로그 메뉴

    • 홈
    • 태그
  • 링크

  • 공지사항

  • 인기 글

  • 태그

    스레드
    Git Flow
    추상 팩토리 패턴
    프로세스
    팩토리 메서드 패턴
    티스토리 코드블럭
    docker volume
    spring 대용량 insert
    도커 볼륨
    멀티프로그래밍
    디자인 패턴
    도커
    Git
    멀티태스킹
    docker compose
    도커 컴포즈
    Docker
    jdbc batchinsert
    도커 명령어
    Mermaid
    멀티프로세싱
    팩토리 패턴
    티스토리 스킨
    멀티스레딩
  • 최근 댓글

  • 최근 글

  • hELLO· Designed By정상우.v4.10.6
Du^
옵시디언 마크다운 가이드
상단으로

티스토리툴바