마크다운 작성 가이드
이 블로그에 글을 쓸 때 쓰는 마크다운 문법을 정리했습니다. Astro에서 그대로 쓸 수 있는 기본 문법들입니다.
제목 (Headings)
<h1>부터 <h6>까지 여섯 단계의 제목을 쓸 수 있습니다. <h1>이 가장 높은 단계이고 <h6>이 가장 낮은 단계입니다.
H1
H2
H3
H4
H5
H6
문단 (Paragraph)
마크다운에서는 빈 줄로 문단을 구분합니다. 한 문단이 너무 길어지면 읽는 사람이 중간에 길을 잃으니, 한국어 글이라면 한 문단에 하나의 주제만 담는 걸 권합니다. 줄바꿈은 문단이 아니라 문장의 호흡을 조절하는 데 씁니다.
이렇게 빈 줄 하나로 새 문단이 시작됩니다.
이미지 (Images)
문법
결과
인용 (Blockquotes)
인용구는 다른 출처에서 가져온 내용을 나타냅니다. 각주나 출처 표기는 footer 또는 cite 요소 안에 넣을 수 있습니다.
출처 없는 인용
문법
> 인용구 안에서도 _마크다운 문법_을 쓸 수 있습니다.결과
인용구 안에서도 _마크다운 문법_을 쓸 수 있습니다.
출처가 있는 인용
문법
> Don't communicate by sharing memory, share memory by communicating.<br>
> — <cite>Rob Pike[^1]</cite>결과
Don’t communicate by sharing memory, share memory by communicating.
— Rob Pike1
표 (Tables)
문법
| 기울임 | 굵게 | 코드 |
| ---------- | --------- | ------- |
| _기울임_ | **굵게** | `코드` |결과
| 기울임 | 굵게 | 코드 |
|---|---|---|
| 기울임 | 굵게 | 코드 |
코드 블록 (Code Blocks)
새 줄에서 백틱(```) 세 개로 열고, 코드를 적은 뒤 백틱 세 개로 닫습니다. 첫 백틱 뒤에 언어 이름(html, javascript, css, typescript, bash 등)을 붙이면 문법 강조가 됩니다.
```html
<!doctype html>
<html lang="ko">
<head>
<meta charset="utf-8" />
<title>예제 문서</title>
</head>
<body>
<p>테스트</p>
</body>
</html>
```결과
<!doctype html>
<html lang="ko">
<head>
<meta charset="utf-8" />
<title>예제 문서</title>
</head>
<body>
<p>테스트</p>
</body>
</html>목록 (List Types)
순서가 있는 목록
문법
1. 첫 번째 항목
2. 두 번째 항목
3. 세 번째 항목결과
- 첫 번째 항목
- 두 번째 항목
- 세 번째 항목
순서가 없는 목록
문법
- 목록 항목
- 다른 항목
- 또 다른 항목결과
- 목록 항목
- 다른 항목
- 또 다른 항목
중첩 목록
문법
- 과일
- 사과
- 오렌지
- 바나나
- 유제품
- 우유
- 치즈결과
- 과일
- 사과
- 오렌지
- 바나나
- 유제품
- 우유
- 치즈
그 밖의 요소 — abbr, sub, sup, kbd, mark
문법
<abbr title="Graphics Interchange Format">GIF</abbr>는 비트맵 이미지 형식입니다.
H<sub>2</sub>O
X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>
<kbd>CTRL</kbd> + <kbd>ALT</kbd> + <kbd>Delete</kbd>를 누르면 세션이 종료됩니다.
대부분의 <mark>도롱뇽</mark>은 야행성이며, 곤충이나 지렁이 같은 작은 생물을 사냥합니다.결과
GIF는 비트맵 이미지 형식입니다.
H2O
Xn + Yn = Zn
CTRL + ALT + Delete를 누르면 세션이 종료됩니다.
대부분의 도롱뇽은 야행성이며, 곤충이나 지렁이 같은 작은 생물을 사냥합니다.