6. 마크다운 기본 문법

 

6강 구현 중심 ⏱ 약 60분

 

0. 학습 목표

→ 5강에서 확인한 마크다운 문법을 직접 입력하고, 배운 문법을 모두 사용해 노트를 직접 작성합니다.

0.1 이번 글에서 다룰 내용

 

• 제목, 문단, 강조, 목록, 체크리스트, 코드 블록, 표 문법을 study-log 노트에 직접 입력하고 읽기 모드에서 표시 결과를 확인
• 위키링크 설정을 끄고 첨부 파일 폴더를 assets로 지정한 뒤, 표준 마크다운 링크로 노트를 연결하고 화면 사진을 노트에 삽입
• 빠른 전환(Ctrl+O)과 전체 검색(Ctrl+Shift+F)으로 원하는 노트와 문장을 찾고, 파일 이름을 영문 소문자와 붙임표로 짓는 규칙의 이유를 15강과 연결해 설명
• 배운 문법을 모두 사용해 1강 내용을 정리한 노트 obsidian-setup을 예시 없이 직접 작성

 

4강에서 study-log 노트를 만들 때 #을 붙인 줄이 제목이 되고 -를 붙인 줄이 목록이 되는 것을 봤습니다. 5강에서는 이 기호 규칙이 마크다운이라는 이름으로 문서에 정의되어 있고, GitHub을 비롯한 여러 서비스가 이 형식을 그대로 사용한다는 것을 확인했습니다.

 

오늘은 그 문법을 직접 입력합니다. 배부받은 예시 노트를 보면서 문법을 하나씩 입력해 표시 결과를 확인하고, 마지막에 배운 문법을 모두 사용해 1강 내용을 정리한 노트를 스스로 작성합니다. 오늘 작성하는 노트는 8강에서 Claude에 질문할 때 근거 자료로 사용합니다.

 

 

 

 

0.2 이번 강의 실습 내용

 

• 5강까지 마친 상태의 Obsidian과 study-notes Vault
• notes 폴더의 study-log 노트(4강에서 만든 노트입니다. 없다면 4강의 학습일지 노트를 만드는 절부터 다시 진행하세요)
• reference 폴더의 markdown-syntax 노트(배부 자료에 들어 있습니다)

 

이 강의에서 study-log는 파일 이름이고, 그 노트의 첫 줄에 적힌 제목은 "학습일지"입니다. 파일 이름과 문서 제목이 다른 이유는 세 번째 절에서 설명합니다.

 

1. study-log 노트에 markdown 기본 문법 사용하기

→ 제목, 문단, 강조, 목록, 체크리스트, 코드 블록, 표 일곱 가지를 직접 입력하고 결과를 확인합니다.

1.1 예시 노트를 보며 연습하는 순서 확인하기

 

reference 폴더의 markdown-syntax 노트(제목: 마크다운 기본 문법 예시)를 사용합니다. 이 노트에는 오늘 다루는 문법이 번호가 붙은 절로 전부 정리되어 있습니다.

 

연습은 세 단계를 반복합니다.

 

1. markdown-syntax 노트에서 해당 번호의 절을 편집 모드로 봅니다. 기호가 그대로 보이는 상태입니다.
2. Ctrl+E로 읽기 모드로 바꿔 그 기호가 어떤 모양으로 표시되는지 확인합니다.
3. study-log 노트로 돌아가 같은 문법을 직접 입력하고 결과를 확인합니다.

 

눈으로 읽기만 하면 문법은 익혀지지 않습니다. 반드시 3단계까지 직접 입력하세요.

 

 

 

 

1.2 제목, 문단, 강조, 목록, 체크리스트를 study-log 노트에 입력하기

 

markdown-syntax 노트의 1번(제목), 2번(문단과 줄바꿈), 3번(강조), 4번(목록), 5번(체크리스트) 절을 차례로 확인한 뒤, study-log 노트 맨 아래에 오늘 분량을 직접 입력합니다.

 

## 6강. 마크다운 문법

마크다운은 텍스트 파일에 기호로 구조를 표현하는 형식이다.

문단을 나누려면 **빈 줄**이 필요하다. 명령은 `git --version`처럼 백틱으로 감싼다.

### 이번 주 할 일

- [x] 1강 Obsidian 설치
- [ ] 6강 마크다운 문법 연습
- [ ] 1강 정리 노트 작성

 

입력한 뒤 Ctrl+E로 읽기 모드에서 확인할 것이 세 가지입니다. ##로 시작한 줄이 중간 크기 제목으로 표시되는지, 두 문장이 서로 다른 문단으로 나뉘는지, 체크박스가 네모 모양으로 표시되는지입니다.

 

확인이 끝나면 두 가지를 일부러 바꿔 보세요. 첫째, 문단 사이의 빈 줄을 지우면 두 문장이 한 문단으로 붙습니다. 둘째, 읽기 모드에서 체크박스를 마우스로 누른 뒤 편집 모드로 돌아가면 [ ]가 [x]로 바뀌어 있습니다. 화면 조작이 결국 텍스트 기호를 바꾸는 일이라는 것을 확인할 수 있습니다.

 

증상	원인	해결 방법
제목이 제목 모양으로 표시되지 않는다	#과 글자 사이에 공백이 없음	# 뒤에 공백 한 칸을 넣는다

강조가 적용되지 않는다면 백틱과 작은따옴표를 혼동한 경우가 가장 많습니다. 백틱(`)은 숫자 1 왼쪽, Esc 아래에 있는 키이고 작은따옴표(')는 Enter 왼쪽에 있는 키입니다.

 

 

 

 

1.3 코드 블록과 표 입력하기

 

markdown-syntax 노트의 6번(코드 블록)과 8번(표) 절을 확인합니다. 이 두 문법은 앞으로 모든 과목에서 명령과 정리 내용을 기록할 때 계속 사용합니다.

 

study-log 노트에 1강에서 사용한 설치 명령과 오늘 배운 기호를 이어서 입력합니다.

### 1강에서 사용한 설치 명령

```bash
sudo snap install obsidian --classic
```

### 오늘 배운 기호

| 기호 | 역할 |
|---|---|
| `#` | 제목 |
| `-` | 목록 |
| `**` | 굵게 |

 

코드 블록은 백틱 세 개로 감싸고 첫 줄에 언어 이름(bash, python 등)을 적습니다. 언어 이름을 적어야 읽기 모드에서 문법에 맞는 색이 입혀집니다.

 

표가 그려지지 않으면 두 번째 줄(|---|---|)이 빠졌거나 줄마다 | 개수가 다른 경우가 대부분입니다. 두 번째 줄을 일부러 지워 표가 깨지는 것을 확인한 뒤, 되돌려서 다시 그려지는 것까지 확인하세요.

 

증상	원인	해결 방법
표가 그려지지 않는다	구분 줄이 없거나 줄마다 세로줄 개수가 다름	두 번째 줄과 각 줄의 세로줄 개수를 대조한다

여기까지가 첫 번째 학습 목표입니다.

 

2. 표준 마크다운 링크로 노트를 연결하고 화면 사진 삽입하기

→ 위키링크 설정을 끄고 첨부 파일 폴더를 지정한 뒤, 노트 링크와 화면 사진을 실제로 삽입합니다.

2.1 위키링크 설정을 끄고 첨부 파일 폴더 지정하기

 

노트가 늘어나면 관련된 노트끼리 연결해 두어야 찾아다니기 쉽습니다. 링크와 이미지를 입력하기 전에 설정 두 가지를 먼저 바꿉니다.

 

Obsidian에는 두 가지 링크 형식이 있습니다.

[[노트이름]] 형식(위키링크)은 입력이 편하지만 Obsidian 안에서만 동작합니다. [표시할 글자](경로) 형식(표준 마크다운 링크)은 어떤 프로그램에서나 동작하고, 15강에서 노트를 웹 사이트로 게시할 때도 이 형식만 링크로 변환됩니다. 그래서 이 과정에서는 표준 마크다운 링크를 사용합니다.

 

1. 왼쪽 아래 톱니바퀴 모양의 [Settings](설정) 버튼을 누릅니다.
2. 왼쪽 목록에서 [Files and links](파일 및 링크)를 선택합니다.
3. [Use [[Wikilinks]]](위키링크 사용) 항목의 스위치를 끕니다.
4. 같은 화면에서 [Default location for new attachments](새 첨부 파일 기본 위치) 항목을 [In the folder specified below](아래에 지정한 폴더)로 바꿉니다.
5. 바로 아래에 나타나는 [Attachment folder path](첨부 파일 폴더 경로)에 assets를 입력합니다.
6. 설정 창을 닫습니다.

 

⚠ 주의: 위키링크 설정을 켠 채로 두면 링크와 이미지가 모두 위키링크 형식으로 만들어집니다. 반드시 끄고 진행하세요. 첨부 파일 폴더를 지정하지 않으면 이미지가 Vault 최상위 폴더에 흩어져 쌓입니다.

 

assets 폴더는 아직 없어도 됩니다. 첫 이미지를 넣는 순간 Obsidian이 그 이름으로 폴더를 만듭니다.

 

 

 

 

2.2 표준 마크다운 링크 입력하기

 

study-log 노트에 예시 노트로 가는 링크를 입력합니다. 괄호 안의 경로는 지금 편집 중인 파일의 위치를 기준으로 적습니다.

문법이 기억나지 않으면 [마크다운 문법 예시](../reference/markdown-syntax.md)를 참조한다.

 

읽기 모드에서 이 링크를 누르면 예시 노트가 열립니다. ../는 한 단계 위 폴더로 올라간다는 뜻입니다. study-log는 notes 폴더에 있고 예시 노트는 reference 폴더에 있으므로, 위로 한 단계 올라갔다가 reference로 내려가는 경로가 됩니다.

 

편집 모드에서는 링크를 그냥 클릭해도 이동하지 않습니다. Ctrl 키를 누른 채 클릭하거나 Ctrl+E로 읽기 모드로 바꾼 뒤 클릭하세요.

 

 

 

 

2.3 화면 사진을 노트에 삽입하기

 

설치 화면이나 오류 메시지는 글로 옮겨 적는 것보다 화면 사진을 그대로 붙여 두는 편이 정확합니다. markdown-syntax 노트의 10번(이미지) 절을 확인한 뒤 직접 해 봅니다.

 

obsidian-screen.png

0.03MB

 

1. Obsidian 본 화면이 보이는 상태에서 PrtSc 키를 눌러 화면 사진을 찍습니다. Ubuntu의 화면 사진 도구가 열리면 영역을 선택하고 저장합니다. 사진은 홈 폴더의 [사진] 폴더에 저장됩니다.
2. 파일 관리자에서 방금 저장된 파일의 이름을 obsidian-screen.png로 바꿉니다. 파일 이름에 한글이나 공백이 들어가면 노트에 삽입될 때 주소가 %EC%82%AC... 같은 문자로 바뀌므로, 지금 영문으로 바꿔 두는 것입니다.
3. Obsidian에서 study-log 노트를 편집 모드로 열고, 파일 관리자에서 obsidian-screen.png 파일을 노트의 원하는 위치로 끌어다 놓습니다.

 

편집 모드에서 삽입된 문장을 확인하세요. 다음과 같은 형태여야 합니다.

![](../assets/obsidian-screen.png)

 

느낌표로 시작하면 링크가 아니라 이미지 삽입입니다. 대괄호 안은 비어 있거나 파일 이름이 들어가 있을 수 있습니다. 이 자리는 이미지가 표시되지 않을 때 대신 나타나는 설명이므로 Obsidian 본 화면처럼 알아볼 수 있는 말로 고쳐 적습니다. 괄호 안의 경로가 ../assets/로 시작하면 앞에서 지정한 첨부 폴더 설정이 적용된 것입니다.

 

왼쪽 파일 목록에 assets 폴더가 새로 생기고 그 안에 obsidian-screen.png가 들어 있으면 첨부 폴더 설정이 적용된 것입니다.

 

증상	원인	해결 방법
링크를 눌러도 이동하지 않는다	경로 오타 또는 편집 모드에서 클릭함	괄호 안 경로와 실제 파일 이름을 대조한다. 편집 모드에서는 Ctrl을 누른 채 클릭한다
링크나 이미지가 대괄호 두 개 형식으로 만들어진다	위키링크 설정이 켜져 있음	[Settings] → [Files and links]에서 위키링크 사용 항목을 껐는지 다시 확인한다
이미지가 assets 폴더가 아닌 곳에 저장된다	첨부 파일 폴더 경로를 지정하지 않음	[Files and links]에서 첨부 파일 폴더 경로가 assets인지 확인한다

여기까지가 두 번째 학습 목표입니다.

 

3. 노트가 늘어난 뒤 원하는 내용을 찾는 방법과 파일 이름 규칙 확인하기

→ 빠른 전환과 전체 검색으로 노트를 찾고, 파일 이름을 영문 소문자로 짓는 이유를 확인합니다.

3.1 빠른 전환과 전체 검색으로 노트 찾기

 

오늘까지는 노트가 몇 개뿐이라 파일 목록에서 눈으로 찾을 수 있습니다. 그러나 7개월 동안 노트가 쌓이면 목록을 훑는 방식은 곧 한계에 부딪힙니다.

 

파일 이름을 알고 있을 때는 빠른 전환을 사용합니다. Ctrl+O를 누르고 study를 입력하면 이름에 그 글자가 들어간 노트 목록이 나타나며, 방향키로 선택하고 Enter를 누르면 해당 노트가 열립니다. 파일 목록에서 폴더를 펼쳐 찾는 것보다 빠릅니다.

 

파일 이름은 기억나지 않고 내용의 한 구절만 기억날 때는 전체 검색을 사용합니다. Ctrl+Shift+F를 누르면 왼쪽에 검색 창이 열립니다. 마크다운을 입력해 보세요. Vault 안의 모든 노트에서 그 낱말이 포함된 줄이 파일별로 표시되고, 결과 줄을 누르면 해당 위치로 이동합니다.

 

두 기능을 구분해 두면 좋습니다. Ctrl+O는 파일 이름으로 찾고, Ctrl+Shift+F는 노트 내용으로 찾습니다. 지금 두 기능을 각각 한 번씩 사용해 markdown-syntax 노트를 열어 보세요.

 

 

 

 

3.2 파일 이름을 영문 소문자로 짓는 이유 확인하기

 

배부받은 폴더의 index 노트에 적힌 규칙 중 하나가 파일 이름 규칙입니다. 내가 만드는 노트의 파일 이름은 영문 소문자와 붙임표(-)로만 짓습니다.

 

이 규칙이 필요한 이유는 15강에 있습니다. 이 폴더가 웹 사이트로 게시되면 파일 이름이 그대로 웹 주소가 됩니다. 한글 파일 이름도 동작은 하지만 주소가 %EB%A7%88%ED%81%AC... 같은 알아볼 수 없는 문자로 바뀌어 길어지고, 다른 사람에게 주소를 전달하기 어려워집니다.

 

파일 이름과 문서 제목은 서로 다르게 지어도 됩니다. 파일 이름은 웹 주소가 되므로 영문으로 짓고, 문서 첫 줄의 1단계 제목은 사람이 읽는 이름이므로 한국어로 적습니다. study-log 노트의 제목이 "학습일지"인 것이 그 예입니다. 여기까지가 세 번째 학습 목표입니다.

 

4. 배운 문법으로 1강 정리 노트 obsidian-setup 직접 작성하기

→ 예시를 보지 않고 배운 문법을 모두 사용해 1강 내용을 정리한 노트를 작성합니다.

4.1 작성 조건에 맞춰 obsidian-setup 노트 작성하기

 

이제 배운 문법을 모두 사용해, 예시를 보지 않고 자기 노트를 작성합니다.

 

notes 폴더에 obsidian-setup이라는 이름으로 새 노트를 만들고, 1강에서 배운 내용(Obsidian 설치와 학습 자료 폴더를 Vault로 여는 과정)을 다음 조건에 맞게 정리하세요. 내용은 옮겨 적지 말고 자기 말로 씁니다.

 

1. 1단계 제목 1개와 2단계 제목 2개 이상을 사용한다.
2. 목록 또는 체크리스트를 1개 이상 사용한다.
3. 굵은 글씨와 인라인 코드를 각각 1회 이상 사용한다.
4. 1강에서 사용한 설치 명령을 코드 블록으로 1개 이상 기록한다.
5. 표를 1개 이상 사용한다.
6. 앞에서 삽입해 본 화면 사진을 이 노트에도 1개 삽입한다.
7. study-log 노트에 이 노트로 가는 표준 마크다운 링크를 추가한다. 두 파일이 같은 notes 폴더에 있으므로 경로는 (obsidian-setup.md)입니다.

 

이 노트는 8강과 9강에서 Claude에 검토를 요청할 때 근거 자료로 사용합니다. 성의 있게 쓸수록 그때 대조할 수 있는 내용이 많아집니다. 이것이 네 번째 학습 목표입니다.

 

5. 오늘 만든 상태를 확인하고 7강 학습으로 연결하기

→ 오늘 만든 노트의 상태를 점검하고, 7강에서 이어질 Claude 활용 학습을 확인합니다.

5.1 오늘 만든 상태 점검하기

 

다음 다섯 가지가 모두 확인되면 6강에서 만들어야 할 상태가 갖춰진 것입니다.

 

1. study-log 노트를 읽기 모드로 열었을 때 제목, 문단, 강조, 목록, 체크리스트, 코드 블록, 표가 모두 의도한 모양으로 표시됩니다.
2. 왼쪽 파일 목록에 assets 폴더가 있고 그 안에 obsidian-screen.png가 있습니다.
3. obsidian-setup 노트를 읽기 모드로 열었을 때 작성 조건 1~6의 요소가 모두 의도한 모양으로 표시됩니다.
4. study-log의 링크를 읽기 모드에서 누르면 obsidian-setup 노트가 열리고, 편집 모드에서 그 링크가 [글자](경로) 형식으로 되어 있습니다.
5. 파일 관리자에서 홈 폴더의 study-notes/notes 폴더를 열면 obsidian-setup.md 파일이 실제로 있습니다.

 

하나라도 확인되지 않으면 해당 문법을 다룬 절로 돌아가 다시 진행하세요.

오늘 강의를 마친 뒤의 학습 자료 폴더 상태

study-notes/notes/
├── study-plan.md         # 🗸 4강에서 작성 완료
├── study-log.md           # ✏️ 이번 강의에서 문법 입력과 링크 추가
└── obsidian-setup.md      # ✏️ 이번 강의에서 새로 작성

study-notes/assets/
└── obsidian-screen.png    # ✏️ 이번 강의에서 삽입

 

✔ 정리: 제목, 문단, 강조, 목록, 체크리스트, 코드 블록, 표를 study-log 노트에 직접 입력해 확인했고, 표준 마크다운 링크와 화면 사진을 노트에 삽입했으며, 배운 문법을 모두 사용해 obsidian-setup 노트를 직접 작성했습니다.

 

오늘 작성한 obsidian-setup 노트를 다시 읽어 보면 정리가 정확한지 스스로 확신하기 어려운 부분이 남아 있을 것입니다. 이런 부분을 확인할 때 AI 도구를 사용합니다.

 

→ 다음 개별 강의

7강에서는 Claude 웹 화면에 직접 로그인해 첫 질문을 보내고, 근거를 주지 않은 답변과 근거를 함께 준 답변이 어떻게 다른지 확인한 뒤 이 과정에서 사용할 규칙을 정합니다. 8강에서는 이 학습 자료 폴더를 Claude 데스크톱 앱에 연결해 오늘 만든 노트를 근거로 질문하고, 답변을 원본과 대조하는 절차를 배웁니다.