DEVLOG JOURNAL

옵시디언을 위한 마크다운 기본 규칙 본문

Development In Unity/Dev Notes

옵시디언을 위한 마크다운 기본 규칙

EVANJ 2026. 7. 1. 01:30

기존에는 노션에서 작업을 기록해왔는데, 옵시디언의 강력한 기능에 매료되어 옵시디언으로 이동하기로 했다.
옵시디언은 마크다운을 기반으로 이루어져 있어, 어디에도 호환이 된다. 그래서 강력한 기록 앱이다.

 

1. 제목

# 제목 1
## 제목 2
### 제목 3
#### 제목 4
##### 제목 5
###### 제목 6
 

# 개수로 제목 단계가 정해지며, Obsidian의 아웃라인에서도 이 제목 구조를 기준으로 문서 목차가 잡힌다.


2. 문단과 줄바꿈

첫 번째 문단입니다.

두 번째 문단입니다.
 

문단을 나누려면 빈 줄을 한 줄 넣어야 한다. 줄만 바꾸면 Markdown에서는 같은 문단으로 처리될 수 있다. Obsidian에서 문단 안 줄바꿈은 줄 끝에 공백 두 칸을 넣거나 Shift+Enter를 사용할 수 있다.

첫 번째 줄  
두 번째 줄

3. 굵게, 기울임, 강조

**굵게**
*기울임*
***굵고 기울임***
~~취소선~~
==형광펜 강조==
 

Obsidian은 굵게, 기울임, 취소선, 하이라이트 문법을 지원한다.


4. 목록

- 항목 1
- 항목 2
  - 하위 항목
  - 하위 항목

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

체크리스트는 이렇게 작성한다.

- [ ] 할 일
- [x] 완료한 일
 

Obsidian에서는 - [ ]가 미완료 작업, - [x]가 완료 작업으로 표시된다.


5. 인용문

> 이것은 인용문입니다.
 

여러 줄 인용은 각 줄 앞에 >를 붙이면 된다.

> 첫 번째 줄
> 두 번째 줄

6. 구분선

---
 

또는

***
 

문서 안에서 큰 구간을 나눌 때 사용한다.


7. 코드

짧은 코드는 백틱 하나로 감싼다.

`ZBrush`, `3ds Max`, `Substance Painter`
 

긴 코드는 백틱 세 개로 감싸.

```csharp
void Start()
{
    Debug.Log("Hello");
}
```
 

Obsidian은 코드 블록에 언어 이름을 붙이면 문법 강조를 적용할 수 있다.


Obsidian에서 특히 중요한 문법

8. 내부 링크

[[Sobek]]
[[Kom Ombo]]
[[Fayum 신학]]
 

Obsidian의 핵심 문법이다. [[노트 이름]]으로 다른 노트와 연결하고 Obsidian은 내부 링크에 Wikilink 형식과 일반 Markdown 링크 형식을 모두 지원한다. 표시 이름을 바꾸고 싶으면 이렇게 작성하면 된다.

[[Sobek|소베크]]
 

특정 제목으로 바로 연결하려면:

[[Sobek#왕권 상징]]
 

특정 문단 블록으로 연결할 수도 있다.

[[Sobek#^crocodile-symbol]]

9. 첨부파일 삽입

이미지나 PDF를 노트 안에 보여주려면 앞에 !를 붙인다.

![[sobek-statue.jpg]]
![[research-paper.pdf]]
 

이미지 크기를 조절하려면:

![[sobek-statue.jpg|300]]
![[sobek-statue.jpg|300x200]]
 

Obsidian 전용 Markdown 확장에는 ![[Link]] 형식의 파일 임베드가 포함된다.


10. 외부 링크

[표시할 이름](https://example.com)
 

예시:

[The Met Museum](https://www.metmuseum.org)
 

이미지 주소를 외부 링크로 넣을 때:

![이미지 설명](https://example.com/image.jpg)

11. 태그

#고증
#디자인
#Sobek
#작업중
#project/sobek
#research/egypt
 

태그는 검색과 분류에 좋다. Obsidian은 /를 사용한 중첩 태그를 지원하고, #inbox/to-read 같은 식으로 계층을 만들 수 있다.
태그에는 공백을 넣을 수 없기 때문에 #snake_case, #kebab-case, #camelCase 같은 방식을 쓰는 게 좋다.


12. 콜아웃

중요한 내용, 경고, 팁을 박스처럼 표시하는 문법이다.

> [!tip] 작업 팁
> 유물 레퍼런스는 출처와 시대를 같이 적어두면 좋다.
> [!warning]
> 고증과 판타지 설정을 섞을 때는 실제 근거와 창작 요소를 분리해두기.
 

접힌 콜아웃도 가능하다.

> [!info]- 접힌 정보
> 클릭하면 열립니다.
 

Obsidian 콜아웃은 > [!info]처럼 인용문 첫 줄에 타입을 넣어 만들고, +나 -를 붙여 기본 펼침/접힘 상태를 정할 수 있다.

자주 쓰는 타입:

> [!note]
> [!info]
> [!tip]
> [!warning]
> [!danger]
> [!question]
> [!example]
> [!quote]
> [!todo]

13. 표

| 항목 | 설명 | 상태 |
|---|---|---|
| Sobek 왕관 | 태양 원반, 깃털, 뿔 조사 | 진행중 |
| Kom Ombo | 프톨레마이오스 시대 자료 확인 | 완료 |
| Fayum | 중왕국 연결성 조사 | 진행중 |
 

정렬도 가능하다.

| 왼쪽 정렬 | 가운데 정렬 | 오른쪽 정렬 |
|:---|:---:|---:|
| 내용 | 내용 | 내용 |
 

Obsidian 표는 |로 열을 나누고, ---로 헤더 구분선을 만드는 방식이다.


14. 주석

이 문장은 보입니다.

%% 이 내용은 편집 화면에서는 보이지만 읽기 화면에서는 보이지 않습니다. %%
 

초안, 개인 메모, 나중에 수정할 내용 표시할 때 좋다.


15. 각주

Sobek는 고대 이집트의 악어 신으로 숭배되었다.[^1]

[^1]: 여기에 출처나 설명을 적는다.
 

짧은 각주는 인라인으로도 가능하다.

이 문장에는 각주가 있다.^[짧은 각주 내용]

고급 문법

16. 속성 / Properties

노트 맨 위에 메타데이터를 넣는 방식이다.

---
title: Sobek Armlet Design
type: design-note
status: 진행중
tags:
  - project/sobek
  - design/armlet
created: 2026-07-01
related:
  - "[[Sobek]]"
  - "[[Kom Ombo]]"
---
 

Obsidian의 속성은 파일 맨 위 YAML 형식으로 저장되고, 이름: 값 구조를 사용해. 값에는 텍스트, 숫자, 체크박스, 날짜, 날짜+시간, 리스트 등을 넣을 수 있다.

---
type: artifact-reference
culture: Ancient Egypt
period: Ptolemaic-Roman
region: Kom Ombo
deity: Sobek
status: 분석중
tags:
  - research/sobek
  - region/kom-ombo
---

17. 수식

$E = mc^2$
 

블록 수식:

$$
E = mc^2
$$
 

Obsidian은 MathJax와 LaTeX 표기법으로 수식을 넣을 수 있다.


18. Mermaid 다이어그램

```mermaid
graph TD
Sobek --> Fayum
Sobek --> KomOmbo
Fayum --> MiddleKingdom
KomOmbo --> PtolemaicRoman
```
 

Obsidian은 mermaid 코드 블록으로 플로우차트, 시퀀스 다이어그램, 타임라인 같은 다이어그램을 넣을 수 있다.


19. 템플릿 기본 양식 작성법

Templater 플러그인을 설치하면 현재 코드를 치환하여 읽기모드로 볼 수 있도록 하는 단축키가 생긴다.

alt + r = "Templater : Replace templates in the active file"

이 단축키로 코드가 잘 작동하는지 확인 할 수 있다. 이전으로 돌리려면 'ctrl + z' Undo 단축키를 사용하면 된다.

 

1.현재 시간 입력하기

<% tp.file.creation_date("YYYY-MM-DD HH:mm") %>

2026-07-03 01:16

<% tp.file.creation_date("YYYY년-MM월-DD일 a H시:m분") %>

2026년-07월-03일 오전 1시:16분

 

2. 제목 그대로 따라 작성하기

<% tp.file.title %>
<% tp.file.title.slice(7) %>

()괄호 안에 숫자 만큼 앞에서 뒤로 계산되어 자르고 뒤의 제목만 작성되도록 하는 기능이다.

<% tp.file.title.slice(0,6) %>

(a,b) a부터 b까지만 제목으로 작성하게 만드는 기능이다.

 

3. 해당 파일의 저장된 폴더 이름 작성

<% tp.file.folder() %>

 

4.해당 파일의 경로 작성

<% tp.file.path() %>

 

5. 날짜 작성

<% tp.date.now("YYYY-MM-DD") %>
<% tp.date.tomorrow("YYYY-MM-DD") %>
<% tp.date.yesterday("YYYY-MM-DD") %>

가장 자주 쓰게 될 요약본

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

**굵게**
*기울임*
==강조==
~~취소선~~

- 목록
  - 하위 목록

1. 번호 목록
2. 번호 목록

- [ ] 할 일
- [x] 완료

[[내부 링크]]
[[노트명|표시 이름]]
[[노트명#제목]]

![[이미지.png]]
![[이미지.png|300]]

#태그
#project/sobek

> 인용문

> [!tip]
> 팁 박스

| 항목 | 설명 |
|---|---|
| 내용 | 내용 |

`짧은 코드`

```csharp
// 긴 코드 블록
 

%% 숨김 메모 %%

'Development In Unity > Dev Notes' 카테고리의 다른 글

API와 MCP  (0) 2026.07.05
'Protocol'에 대해  (0) 2026.07.05