마크다운

마크다운 (Markdown)은 마크업 언어의 일종으로, 존 그루버(John Gruber)[1]와 애런 슈워츠가 만들었다. 온갖 태그로 범벅된 HTML 문서 등과 달리, 읽기도 쓰기도 쉬운 문서 양식을 지향한다. 그루버는 마크다운으로 작성한 문서를 HTML로 변환하는 Perl 스크립트도 만들었다.[2] 흔히 볼 수 있는 문서(파일명)은 'README.md', 파일의 확장자는 .md 또는 .markdown을 쓴다.[3]

여기서 언급하는 '위키 문법'은 나무마크가 기준입니다.
또한 마크다운은 표준이 없기 때문에 가장 보편적으로 허용되는 기본적인 문법만 소개합니다.[4]

위키 문법의 == 개요 ==에 대응하는 문법이다. 6단계까지 할 수 있다.

# 1단계 제목
## 2단계 제목

줄 바꿈을 두 번 하면 된다.

첫째 문단입니다. 문장이 두 개죠.

둘째 문단입니다. 저도
문장이 두 개입니다.

마크다운은 기본적으로 강제 개행을 인식하지 않기 때문에, 두 번째 예시를 HTML 등으로 변환할 경우 줄 바꿈이 없는 '둘째 문단입니다. 저도 문장이 두 개입니다.'로 변환된다. 강제 개행을 인식하게 하려면 줄 끝에 공백을 두 칸 넣거나(가독성 문제로 권장되지 않음), 아니면 줄 끝에 역슬래시(\)를 넣어도 된다.

위키 문법과 같으나 첫 번째 칸을 띄어 쓰지 않아도 된다.

* 목록 하나
    * 목록 하나에 하나
* 목록 둘
* 목록 셋
- 이렇게 써도
- 된답니다.

순서가 있는 목록은 다음과 같이 쓴다. 숫자는 반드시 맞춰 쓸 필요는 없다. 모든 항목을 1.로 맞추어도 상관 없고, 스타일 가이드에 따라서는 (추후 항목을 추가하거나 삭제할 때 용이하다는 이유로) 그렇게 할 것이 권장되기도 한다. 어차피 마크다운 기본 문법에서는 각 행이 HTML의 <li> 태그로 변환되는 것일 뿐이라 번호 정보가 사라지기 때문.

1. 첫째입니다.
2. 둘째입니다.
3. 셋째입니다.
5. 넷째입니다. 
    5. 다섯째 아닙니다.
        6. 여섯째도 아니고요.
6. 이게 다섯째입니다.
4. 이건 여섯째.

굵은 글자는 다음과 같이 쓴다. 위키 문법 '''굵게'''에 대응하는 문법이다.

**굵게** 쓰거나 __두껍게__ 쓰거나

결과: 굵게 쓰거나 두껍게 쓰거나

기울임 꼴 글자는 다음과 같이 쓴다. 위키 문법 ''기울게''에 대응하는 문법이다.

*기울게* 쓰면서 _기울게_ 쓴다

결과: 기울게 쓰면서 기울게 쓴다

(특히 프로그래밍 관련 문서에서) 코드를 입력할 필요가 있을 땐 다음과 같이 쓴다. 고정 폭 글꼴로 출력되며 위키 문법 {{{ code }}}에 대응하는 문법이다.

문장 중간에 표시할 땐 다음과 같이 쓴다.[5]

예를 들어 `import antigravity` 이렇게요.

여러 줄의 코드는 백틱(`) 3개로 감싸서 다음과 같이 쓴다. 이와 같이 여러 줄을 묶어놓은 것을 흔히 '코드블록'이라고 부른다.

```javascript
const test = '위에 javascript는 실제로 보이지 않고, ';
const other = '대부분 어떤 언어인지 알려주는 용도입니다.';
console.log(test, other);
console.log("가끔씩은 파일 이름을 쓰기도 합니다.")
```

줄 첫 번째마다 >를 쓰면 된다. 위키 문법에도 동일하게 쓴다.

> > 빛이 있으라.
>
> 하니 빛이 있었다.

결과:

링크는 다음과 같이 쓴다. 위키 문법에 대응하는 문법이다.

[나무위키](https://namu.wiki/w/나무위키:대문)

또는 다음과 같이 써서 주석 형태로 링크를 쓸 수 있다.

출처는 [위키백과][wiki]입니다.

[wiki]: http://en.wikipedia.org/wiki/Markdown#Syntax_examples "위키백과 Markdown 항목"

그림을 넣을 땐 다음과 같이 쓴다.

![세피로트](https://cdn.namu.wiki/r/http%3A%2F%2Fi.imgur.com%2F2megHz2.png "툴팁 메시지. 이 부분은 생략해도 됩니다.")

또는 다음과 같이 써서 주석 형태로 그림을 넣을 수 있다.

![세피로트][SD]

[SD]: https://cdn.namu.wiki/r/http%3A%2F%2Fi.imgur.com%2F2megHz2.png "툴팁 메시지. 이 부분은 생략해도 됩니다."

"세피로트" 부분은 HTML img 태그의 alt 속성에, "툴팁 메시지" 부분은 title 속성에 해당한다.

가로줄을 넣는 문법은 여러 가지가 있다. 위키 문법의 ---- 에 대응하는 문법이다.

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

위키 문법의 || 1 || 2 || 에 해당하는 문법이다.
표를 만드는 문법은 이렇게 사용한다.

| 1 | 2 |
|---|---|
| 1 | 2 |

1번째 줄은 제목,
3번째 줄부터는 내용이다.
결과:

Github-Flavored Markdown
GitHub, 디스코드에서 쓰이며 다음과 같은 차이점이 있다.

MultiMarkdown
기존 마크다운에 없는 기능(주석, 표 등)이 추가되어 있다.

하루패드에서 쓰이며 다음과 같은 차이점이 있다.

사실상 개발자 내지 개발 관련 직군만이 주로 사용하는 문법이었지만 LLM의 보급과 함께 LLM이 플레인텍스트 출력을 렌더하는 용도로 사용하기 시작하며 일반인도 접할 기회가 소폭 늘어나게 되었다. 특히 마크다운 렌더가 지원되지 않는 플랫폼에 뜬금없이 마크다운 문법이 그대로 보이면 LLM 사용을 의심해도 좋을 정도.