마크다운(Markdown) 핵심 규칙 10가지

마크다운(Markdown)​ 핵심 규칙 10가지 

마크다운이란?

마크다운(markdown)은 일반 텍스트 기반의 경량 마크업 언어다. 일반 텍스트로 서식이 있는 문서를 작성하는 데 사용되며, 일반 마크업 언어에 비해 문법이 쉽고 간단한 것이 특징이다.

• 위키피디아

마크다운 언어는 어렵지 않습니다. 30분만 익히고 연습하시면 능숙하게 마크다운을 사용하시게 될 겁니다. 마크다운은 쉽게 말해 단순한 일반 텍스트를 특정 규칙에 맞게 작성하면 알아서 제목으로 만들어주기도 하고, 두껍게 보이게도 하며, 목록, 체크박스 등등으로 서식이 있는 텍스트로 바꿔주는 것입니다. 이렇게 만들어주는 규칙이 매우 쉽고 직관적입니다. 마크다운은 개발자 중심에서 대중적으로 많이 사용되고 있습니다. 마크다운은 다음과 같은 장점이 있기 때문입니다.

 

마크다운 장점

1. 쉬운 문법으로 글쓰기에만 온전히 집중
2. 가볍게 읽고 쓸 수 있는 단순한 텍스트 파일
3. 사전 정의된 서식 파일을 이용해 최소 수준의 서식 보장

마크다운 핵심 문법

마크다운 문법은 매우 간단합니다. 몇 가지 핵심적인 문법에 대해서 알아봅니다.

• 제목(Heading)
• 목록(List)
• 체크박스(Checkbox)
• 구분선(Horizontal Line)
• 강조(Strike)
• 줄바꿈(Line Break)- 인용문(Quote)
• 코드블록(Code Block)
• 링크(Link)
• 표(Table)
• 수식(Math )
• 이미지(Image)

1. 제목(Heading)

제목(Heading)은 굵고 큰 글씨로 주제목, 부제목 등 제목을 설정할 때 사용합니다. '#' 바로 뒤에 띄어쓰기를 하면 제목으로 인식합니다. ' #'의 갯수에 따라서 제목, 부제목 순으로 작은 단위로 변합니다. 총 6개까지 할 수 있습니다.

 

 

노트 패널을 편집모드로 바꾸고 다음과 같이 작성해보세요

# 제목 1 입니다.
## 제목 2 입니다.
### 제목 3 입니다.
#### 제목 4 입니다.
##### 제목 5 입니다.
###### 제목 6 입니다.

2. 수평선(Horizontal Line)

글을 분리할 때 사용하는 수평선입니다. 보통은 --- 또는 *** 을 많이 사용합니다.

---
***
*************
-----------------------
- - - 
* * *

주의할 점은 '---'을 이용한 수평선은 윗줄에 문자가 있으면 주제목('#')처럼 인식한다는 점입니다.

# 제목입니다.

제목입니다.
---

3. 목록(List)

목록은 나열할 때 많이 사용됩니다. 순서가 없는 목록과 순서가 있는 목록으로 나뉩니다.

 

순서가 없는 목록

순서가 없는 목록은 -, * ,+ 다음에 띄어쓰기 하고 내용을 적으면 됩니다. 옵시디언에서는 목록을 인식하기 때문에 엔터를 치면 다음 항목도 저절로 - 가 입력됩니다. 한 단락 들여쓰기를 하고 싶다면 Tab을 눌러서 들여쓸 수 있습니다.

• 순서 없는 항목입니다. - 다음에 띄어쓰기를 하고 내용을 적습니다.
• 엔터를 쳐서 아래로 내려가면 자동으로 - 가 생깁니다.
  • 들여쓰기도 가능합니다.
    • 여러번 들여쓰기도 가능합니다.

- 순서 없는 항목입니다. `-` 다음에 띄어쓰기를 하고 내용을 적습니다.
- 엔터를 쳐서 아래로 내려가면 자동으로 `-` 가 생깁니다.
    - 들여쓰기도 가능합니다. 
        - 여러번 들여쓰기도 가능합니다.

순서가 있는 목록

순서가 있는 목록은 숫자를 적고 . 마침표를 찍은 뒤에 띄어쓰기 후 내용을 적으면 됩니다. 마찬가지로 옵시디언에서 순서 있는 목록으로 인식하기 때문에 엔터를 치면 저절로 숫자가 증가됩니다. 중간에 다른 숫자를 쓰더라도 미리보기(프리뷰)모드에서는 숫자를 위에서부터 순서대로 인식하게 됩니다.

1. 순서가 있는 항목입니다.
2. 숫자를 쓰고 .을 찍고 띄어쓰기를 한 다음에 내용을 적습니다.
   1. 마찬가지로 들여쓰기가 가능합니다.
      • 순서가 있는 항목과 순서가 없는 항목을 혼용해서 사용할 수 있습니다.

1. 순서가 있는 항목입니다.
2. 숫자를 쓰고 `.`을 찍고 띄어쓰기를 한 다음에 내용을 적습니다. 
    1. 마찬가지로 들여쓰기가 가능합니다.
        - 순서가 있는 항목과 순서가 없는 항목을 혼용해서 사용할 수 있습니다. 

4. 체크박스(Checkbox)

할 일 등을 표시할 때 사용되는 체크박스를 쉽게 적을 수 있습니다. - [ ] 마이너스 기호, 대괄호 기호와 띄어쓰기 입력 후 내용을 적으면 됩니다. 주의할 점은 대괄호 안에도 띄어쓰기를 해야한다는 점입니다. 대괄호 안에 x를 입력하면 완료한 항목을 나타냅니다. 옵시디언에서는 미리보기 모드에서 마우스로 클릭해서 완료표시할 수 있습니다.

꽤 자주 사용하는 항목으로 옵시디언에서는 단축키로 제공합니다. 단축키는 Ctrl/Cmd + Enter 입니다.

- [ ] `- [ ]`를 입력하고 한 칸 띄어쓰기 하고 내용을 적습니다. 
- [X] 표시를 하면 프리뷰 모드에서 체크가 된 것으로 보여집니다

• - [ ]를 입력하고 한 칸 띄어쓰기 하고 내용을 적습니다.
• 표시를 하면 프리뷰 모드에서 체크가 된 것으로 보여집니다

5. 강조 및 취소선

문장 또는 단어를 강조하거나 취소선을 그을 때 사용합니다. *, _, =, ~을 이용해서 아주 간단하게 할 수 있습니다.

 

이탤릭

*단어 또는 문장*
_단어 또는 문장_

이탤릭은 글자를 기울이면서 단어 또는 문장을 강조합니다. * 또는 _를 1개씩 원하는 곳 앞 뒤에 적어 적용시킬 수 있습니다.

 

굵게

**단어 또는 문장**

"굵게"는 단어 또는 문장을 굵게 처리해 강조합니다. ** 를 원하는 곳 양 쪽에 적어 사용합니다.

 

하이라이트

==단어 또는 문장==

단어 또는 문장에 하이라이트(형광펜)처리를 해서 강조합니다. 원하는 곳 앞 뒤에 == 을 적어 사용합니다.

 

취소선

~~단어 또는 문장~~

단어 또는 문장 중간에 가로선을 그어 취소를 나타낼 수 있습니다. 앞 뒤에 물결 표시인 ~~ 을 붙여서 사용합니다.

6. 인용블록(Quote)

다른 글을 참조할 때 사용되는 인용블록입니다. > 오른쪽 꺽쇠와 띄어쓰기 입력 후 내용을 적으면 됩니다.
인용 블록 안에서도 다른 마크다운 문법이 인식이 됩니다.

> 을 이용해서 html상의 특별한 서식인 인용을 나타낼 수 있습니다.
다른 마크다운 문법(제목, 목록, 강조 등)도 적용됩니다.

제목2

• 목록 1
  • 목록 2
• 강조
• 취소선

> `>` 을 이용해서 html상의 특별한 서식인 인용을 나타낼 수 있습니다. 
> 다른 마크다운 문법(제목, 목록, 강조 등)도 적용됩니다. 
> ##### 제목
> - 목록 1
>     - 목록 2
> -  **강조** 
> - ~~취소선~~ 

7. 코드블록(Code Block) 및 인라인코드(Inline Code)

코드블록과 인라인코드는 마크다운 문서에 코드 내용을 작성할 때 사용합니다.

 

코드 블록(Code Block)

프로그래밍 문법 맞게 키워드를 강조하는 하이라이팅(syntax highlighting)기능을 지원합니다.
백틱(backtick)인 `을 연달아 3개를 쓰고(```) 뒤에 원하는 언어 명시하고 코드를 작성합니다. 그리고 다시 ``` 로 블록을 감싸주면 됩니다.

```js
function fancyAlert(arg) {
  if(arg) {
    $.facebox({div:'#foo'})
  }
}
```

function fancyAlert(arg) {
  if(arg) {
    $.facebox({div:'#foo'})
  }
}

 

인라인 코드(Inline Code)

문장 중간에 코드를 사용할 때 백틱(backtick)을 ` 2개 사이에 코드(예: a = 1 + 2)를 작성합니다.

이렇게 중간에 `a = 1 + 2` 코드를 넣을 수 있습니다.

8. 표(Table)

놀랍게도 마크다운을 이용해서 표를 만들 수 있습니다. ( | )와 ( - )를 이용해서 빠르게 표를 만들 수 있습니다. 이 기호들로 셀을 하나씩 만든다고 생각하면 편합니다. 첫번째 행은 행 제목을 입력합니다. 두번째행은 구분하는 행입니다. | 사이에 --- 을 입력합니다. 이 때 -의 갯수는 중요하지 않습니다. | 와는 한 칸씩 떨어져있어야 합니다. 두번째 행에서 콜론 기호( : )를 이용해서 으로 왼쪽, 가운데, 오른쪽 정렬을 할 수 있습니다.

| 첫번째 열                    |           오른쪽 정렬 | 왼쪽 정렬        |     가운데정렬     |
| ---------------------------- | ---------------------:|:---------------- |:------------------:|
| \| 사이에 내용을 입력합니다. | 오른쪽 정렬이 됩니다. | 왼쪽 정렬입니다. | 가운데 정렵입니다. |
| 한줄 더 추가할 수 있습니다.  |                       |                  |                    |

첫번째 열	오른쪽 정렬	왼쪽 정렬	가운데정렬
| 사이에 내용을 입력합니다.	오른쪽 정렬이 됩니다.	왼쪽 정렬입니다.	가운데 정렵입니다.
한줄 더 추가할 수 있습니다.

9. 링크(Link)

외부의 웹페이지 링크를 입력할 때 사용합니다. URL 링크 주소 그대로 표현되지 않고 대괄호 안의 문자열로 링크를 표현합니다. 클릭해서 링크를 열 수 있습니다.

[제목](url 링크)

예시)

[네이버](https://www.naver.com/)

실제)
네이버

10. 이미지(Image)

이미지를 문서에 넣을 때 사용합니다. 사용방법은 링크와 유사합니다.
사진 제목과 이미지 주소를 대괄호와 소괄호에 입력합니다. 그리고 맨 앞에 !를 붙입니다.
특이한 점은 인터넷 상의 이미지는 다운로드를 받지 않고 이미지 주소를 복사해서 넣어도 됩니다.
내 컴퓨터에 있는 이미지를 사용하는 경우에는 절대경로 또는 상대 경로를 입력합니다.

![제목](이미지 주소)

예시)

![산 예제](https://bit.ly/3CtGPq0)

실제)

 

옵시디언의 내부링크 [[ ]] 는 마크다운에서 공식으로 지원하는 문법이 아닙니다. 옵시디언이 아닌 다른 에디터에서 문서를 편집할 때 내부링크가 동작하지 않을 수 있습니다.

 

 

---

한국에서는 옵시디언에 대한 정보가 많이 부족합니다. 부족한 옵시디언에 대한 정보와 사용방법 그리고 꿀팁들을 "Obsidian 옵시디언 사용자 모임" 네이버 카페와 "Obsidian 사용자모임" 오픈카톡방에서 소통을 하고 있습니다. 많이 참여해주세요! 😄

Obsidian 옵시디언 사용자 모임 : 네이버 카페

Obsidian 사용자 모임