블로그로 돌아가기

마크다운 문법 80/20: 꼭 알아야 할 것만 익히기

Published
태그
markdown 노트 생산성

한 단락으로 이해하는 마크다운

마크다운은 일반 텍스트에 간단한 기호만 더해 HTML(또는 PDF, 문서, 웹페이지)로 변환할 수 있게 해주는 가벼운 포맷입니다. #로 제목을, -로 목록을 만드는 식이라 배우기도 쉽고, 결과물도 결국 .md 텍스트 파일이라 소유권을 온전히 지킬 수 있습니다.

마크다운 문법 80/20 핵심

아래 것들만 익혀도 거의 모든 글을 작성할 수 있습니다.

제목

# 제목
## 섹션
### 하위 섹션

강조

**굵게**   // 별 두 개
*기울임*   // 별 한 개

목록

- 항목
- 또 다른 항목
  - 하위 항목
1. 첫 번째
2. 두 번째

링크와 이미지

[링크 텍스트](https://example.com)
![이미지 ALT](path-or-url-to-image.jpg)

코드와 인용

`인라인 코드`
# 코드 블록
```
print("hello")
```
> 인용문은 노트, 주석, 인용에 사용할 수 있습니다.

### 구분선
---

팁: 제목은 # + 공백, 목록은 - + 공백만 기억하세요. 이 두 가지만 기억해도 80% 상황에서 바로 써먹을 수 있습니다.

10분 연습 루틴

다음 순서로 한 번만 따라해도 손에 익습니다.

  1. 새 노트를 만들고 제목을 추가하세요: # 나의 첫 마크다운 노트
  2. 짧은 소개와 강조를 넣어 보세요: 나는 *마크다운*을 **가볍게** 배우고 있다.
  3. 체크리스트를 작성합니다: - [ ] 마크다운 에디터 설치 - [ ] 간단한 목차 작성 - [ ] .md 파일로 저장
  4. 코드 블록을 추가합니다:
mkdir notes && cd notes
echo "Hello" > hello.md
  1. 링크와 이미지를 넣어보세요: 자세한 내용은 [CommonMark](https://commonmark.org)에서 확인![도움이 되는 다이어그램](./diagram.png)
  2. 구분선과 인용으로 마무리하세요: ---> 서식이 단순할수록 글쓰기에만 집중할 수 있습니다.

이 루틴을 한 번만 따라해도 핵심 문법을 모두 써본 셈입니다.

자주 하는 실수와 해결책

  • 제목에 공백을 빼먹음 — ##제목 ❌ → ## 제목 ✅
  • 목록 표시 뒤 공백 없음 — -항목 ❌ → - 항목 ✅
  • 어색한 줄바꿈 — 일부 렌더러는 블록 사이에 빈 줄이 있어야 섹션이 구분됩니다.
  • 코드 블록 닫기 누락 — 여는 백틱 3개, 닫는 백틱도 3개입니다. 따옴표와 섞지 마세요.
  • 이미지 경로 오류 — 파일 위치를 다시 확인하세요. 하위 폴더에 있다면 ./images/pic.jpg처럼 상대 경로를 사용합니다.

.md 파일의 장점

마크다운 노트는 확장자 .md만 붙은 텍스트 파일입니다. 그래서 다음과 같은 장점이 있습니다.

  • 이식성 — 어떤 에디터에서도 열고 편집할 수 있습니다. (VS Code, Obsidian, Mdit 등)
  • 버전 관리 — Git으로 변경 이력을 관리하기 쉽습니다.
  • 미래 지향성 — 순수 텍스트라 특정 서비스에 종속되지 않습니다.

Mdit에서는 노트를 .md 그대로 iCloud, Google Drive, Dropbox, 로컬 폴더 등에 저장할 수 있습니다. 작업 공간만 고르면 파일은 온전히 내 소유입니다.

시작 템플릿

회의록

# 회의: {주제}
**날짜:** {YYYY-MM-DD}  
**참석자:** {이름}

## 안건
- 

## 메모
- 

## 결정 사항
- 

## 액션 아이템
- [ ] 담당자 – 작업 (기한)

데일리 로그

# {YYYY-MM-DD}
## 오늘의 핵심 3가지
1. 
2. 
3. 

## 메모
- 

## 오늘의 성과
-

프로젝트 README

# {프로젝트 이름}
{한 줄 소개}

## 설정
# 실행 명령어

## 사용법
- 

## 로드맵
- [ ] 마일스톤 1
- [ ] 마일스톤 2

Mdit을 지금 써보세요 (무료, 로컬 우선)

“외우지 않아도 되는” 접근을 원한다면 Mdit이 딱 맞습니다.

  • 슬래시 명령으로 빠르게 블록을 추가
  • 10MB 이하의 가벼운 집중형 에디터
  • 로컬 우선 저장으로 .md 파일을 그대로 보관

복잡한 설정 없이 바로 글쓰기를 시작해 보세요.

홈으로