Markdown 기본 문법
Markdown은 간단한 문법을 가진 경량 마크업 언어로, 형식보다는 콘텐츠에 더 집중할 수 있게 해줍니다. 읽기 쉽고 작성하기 쉬운 일반 텍스트 형식을 사용하며, HTML과 혼합할 수 있고 HTML, PDF 또는 자체 .md 파일 형식으로 내보낼 수 있습니다.
디자인 철학
Markdown의 목표는 "가독성과 작성의 용이성"입니다.
가독성이 가장 중요합니다. Markdown으로 작성된 파일은 일반 텍스트로 게시 가능해야 하며, 태그나 형식 지침으로 가득 찬 것처럼 보이지 않아야 합니다.
Markdown 문법의 주요 디자인 목표는 가능한 한 읽기 쉽게 만드는 것입니다. 이 목표를 바탕으로 Markdown 문서는 태그나 형식 지침으로 가득 찬 것처럼 보이지 않고 일반 텍스트로 게시될 수 있습니다.
—— John Gruber
HTML 호환성
Markdown 문법의 목표는 웹에 적합한 작성 언어가 되는 것입니다.
Markdown은 HTML을 대체하려는 것이 아니며, 심지어 HTML에 가깝게 만들려는 것도 아닙니다. 그 문법은 제한적이며 HTML 태그의 작은 부분집합만 다룹니다.
Markdown에서 다루지 않는 태그는 HTML을 사용하여 문서에 직접 작성할 수 있습니다. HTML인지 Markdown인지 표시할 필요가 없으며, 태그를 직접 추가하면 됩니다.
예를 들어, Markdown 파일에 HTML 테이블을 추가합니다:
This is a regular paragraph.
<table>
<tr>
<td>Foo</td>
</tr>
</table>
This is another regular paragraph.자동 특수 문자 변환
HTML 파일에서는 두 문자에 특별한 처리가 필요합니다: <와 &.
<는 여는 태그에 사용됩니다&는 HTML 엔티티에 사용됩니다
Markdown은 이러한 문자를 자연스럽게 작성할 수 있게 하고 변환을 처리해줍니다. 사용하는 &가 HTML 엔티티의 일부라면 보존되고, 그렇지 않으면 &로 변환됩니다.
기본 문법 요소
Markdown의 기본 문법에는 다음 요소들이 포함됩니다:
블록 요소
- 제목 -
#을 사용하여 다양한 수준의 제목 생성 - 단락과 줄바꿈 - 텍스트 단락과 줄바꿈 규칙
- 인용문 -
>를 사용하여 인용문 생성 - 목록 - 순서가 있는 목록과 순서가 없는 목록
- 코드 블록 - 코드를 표시하기 위한 특별한 형식
- 수평선 - 수평선 생성
인라인 요소
기타
문법 예제
다음은 다양한 기본 문법 요소를 포함한 예제입니다:
# 내 문서
이것은 **굵은 텍스트**와 *기울임꼴 텍스트*의 예제입니다.
## 목록 예제
### 쇼핑 목록
- 사과
- 바나나
- 오렌지
### 작업 목록
1. Markdown 기본 배우기
2. 작성 연습하기
3. 친구들과 공유하기
> 이것은 인용문의 예제입니다. Markdown은 작성을 간단하고 우아하게 만듭니다.
이것은 [홈페이지로의 예제 링크](/ko/)입니다.
코드 예제:인라인 코드도 사용할 수 있습니다. 예를 들어 console.log('Hello World')와 같습니다.
모범 사례
제목
- 문서당 하나의 1단계 제목(
#)만 사용 - 제목 수준을 논리적으로 유지하고 수준을 건너뛰지 않기
- 제목 앞뒤에 빈 줄 두기
목록 형식
- 순서가 없는 목록 기호를 일관되게 유지(
-,*,+중 하나만 사용) - 여러 단락이 없는 한 목록 항목 사이에 빈 줄이 필요하지 않음
링크와 이미지
- 링크에 의미 있는 텍스트 설명 제공
- 이미지에 대체 텍스트 제공
코드 표시
- 짧은 코드에는 인라인 코드 사용
- 길거나 여러 줄의 코드에는 코드 블록 사용
- 구문 강조를 위해 코드 블록에 언어 지정
도구 지원
거의 모든 Markdown 애플리케이션이 이러한 기본 문법 요소를 지원합니다. 다른 Markdown 프로세서 간에 약간의 차이가 있을 수 있지만, 기본 문법은 보편적입니다.
다음 단계
이제 Markdown의 기본 문법에 대한 개요를 갖게 되었으므로 다음을 할 수 있습니다:
특정 문법 요소 학습 시작: