마크다운(Markdown) 완벽 정복: 쉽고 빠른 문서 작성법

안녕하세요! 오늘은 개발자, 블로거, 작가 등 많은 분들이 애용하는 마크다운(Markdown) 문법에 대해 알아보겠습니다.

마크다운은 배우기 쉽고, 쓰기 편하며, 다양한 플랫폼에서 호환되는 강력한 텍스트 기반 마크업 언어입니다. 이 포스팅 하나로 마크다운의 기본부터 활용까지 마스터해보세요!

마크다운이란?

마크다운은 일반 텍스트 기반의 경량 마크업 언어입니다. 복잡한 HTML 태그 대신, 사람이 읽고 쓰기 쉬운 문자를 사용하여 웹 문서를 작성할 수 있도록 고안되었습니다. 마크다운으로 작성된 문서는 쉽게 HTML로 변환될 수 있어, 웹사이트, 블로그, README 파일, 기술 문서 등 다양한 곳에서 활용됩니다.

 

왜 마크다운을 사용할까요?

• 가독성: 원본 텍스트 자체가 읽기 쉽습니다.
• 단순함: 문법이 매우 간단하여 배우기 쉽습니다.
• 플랫폼 독립성: 텍스트 파일이므로 어떤 OS나 편집기에서도 작업할 수 있습니다.
• 집중도 향상: 서식보다는 콘텐츠 작성에 집중할 수 있습니다.
• 빠른 변환: HTML, PDF 등 다양한 형태로 쉽게 변환 가능합니다.

필수 마크다운 문법

이제 가장 자주 사용되는 마크다운 문법들을 예제와 함께 살펴보겠습니다.

1. 제목 (Headers)

# 기호를 사용하여 제목을 표현합니다. #의 개수에 따라 H1부터 H6까지 제목 수준을 나타낼 수 있습니다.

# 이것은 H1 제목입니다
## 이것은 H2 제목입니다
### 이것은 H3 제목입니다
#### 이것은 H4 제목입니다
##### 이것은 H5 제목입니다
###### 이것은 H6 제목입니다

2. 강조 (Emphasis)

텍스트를 굵게, 기울임꼴, 취소선 등으로 강조할 수 있습니다.

*이것은 기울임꼴(italic)입니다*
_이것도 기울임꼴(italic)입니다_

**이것은 굵게(bold)입니다**
__이것도 굵게(bold)입니다__

~~이것은 취소선(strikethrough)입니다~~

***굵고 기울임꼴***
___이것도 굵고 기울임꼴___

3. 목록 (Lists)

숫자와 점(.)을 사용합니다.

1. 첫 번째 항목
2. 두 번째 항목
   1. 중첩된 첫 번째 항목 (들여쓰기)
   2. 중첩된 두 번째 항목
3. 세 번째 항목

별표(*), 하이픈(-), 또는 더하기 기호(+)를 사용합니다.

* 별표를 사용한 목록
  - 하이픈을 사용한 중첩 목록
    + 더하기 기호를 사용한 또 다른 중첩 목록
- 하이픈을 사용한 목록
+ 더하기 기호를 사용한 목록

4. 링크 (Links)

인라인 링크와 참조 링크 방식이 있습니다. 주로 인라인 링크를 많이 사용합니다.

[Google](https://www.google.com)
[티스토리](https://devblog.tistory.com "블로그로 이동합니다")

5. 이미지 (Images)

링크와 비슷하지만, 앞에 느낌표(!)를 붙입니다.

![대체 텍스트](이미지_URL_경로 "이미지 설명 - 선택사항")
![GitHub 로고](https://github.githubassets.com/images/modules/logos_page/GitHub-Mark.png "깃허브 로고")

(주의: 위 이미지 URL은 예시이며, 실제 유효한 URL을 사용해야 이미지가 보입니다.)

6. 코드 블록 (Code Blocks)

프로그래밍 코드를 삽입할 때 유용합니다. 백틱 세 개(```)로 감싸거나, 탭 또는 공백 4칸으로 들여쓰기하여 표현합니다.

백틱 세 개로 감싸고, 첫 번째 백틱 뒤에 언어 이름을 명시하면 구문 강조(Syntax Highlighting)가 적용될 수 있습니다.

```python
def hello():
    print("Hello, Markdown!")

function greet() {
    console.log("Hello, Markdown!");
}

일반 텍스트 블록입니다.
특별한 구문 강조 없이 표시됩니다.

##### 들여쓰기 코드 블록 (Indented Code Blocks)

```markdown
    // 이 줄은 4칸 들여쓰기 되었습니다.
    p {
      color: red;
    }

7. 인라인 코드 (Inline Code)

문장 내에 짧은 코드를 삽입할 때는 백틱 하나( `)로 감쌉니다.

파이썬에서 `print()` 함수는 출력을 위해 사용됩니다.
HTML에서 `<p>` 태그는 문단을 나타냅니다.

8. 인용문 (Blockquotes)

인용문을 작성할 때는 > 기호를 사용합니다. 중첩도 가능합니다.

> 이것은 인용문입니다.
> 여러 줄에 걸쳐 작성할 수 있습니다.
>
> > 이것은 중첩된 인용문입니다.

9. 수평선 (Horizontal Rules)

주제를 나누거나 내용을 구분할 때 사용합니다. 별표(*), 하이픈(-), 또는 밑줄(_)을 3개 이상 연속으로 사용합니다.

내용 섹션 1
---
내용 섹션 2
***
내용 섹션 3
___

10. 표 (Tables) - (확장 문법)

일부 마크다운 파서에서는 표를 지원합니다. 하이픈(-)으로 헤더와 셀을 구분하고, 파이프(|)로 열을 구분합니다.

| 헤더 1 | 헤더 2 | 헤더 3 |
| :----- | :----: | -----: |
| 내용 1 (왼쪽 정렬) | 내용 2 (가운데 정렬) | 내용 3 (오른쪽 정렬) |
| 셀 4   |  셀 5  |   셀 6 |

(콜론(:)을 사용하여 정렬을 지정할 수 있습니다.)

 

마크다운 활용 팁

• 미리보기 활용: 마크다운을 지원하는 편집기(VS Code, Typora, Notion 등)나 웹사이트(GitHub, StackEdit 등)는 실시간 미리보기 기능을 제공합니다. 이를 활용하면 작성 중인 문서가 어떻게 보일지 바로 확인할 수 있습니다.
• 연습, 또 연습: 가장 좋은 학습 방법은 직접 사용해보는 것입니다. 간단한 메모부터 시작해보세요.
• 확장 문법: 기본 마크다운 외에도 GitHub Flavored Markdown(GFM) 등 다양한 확장 문법이 존재합니다. (예: 표, 작업 목록 - [x] 등) 사용하는 플랫폼이 어떤 마크다운을 지원하는지 확인해보세요.

맺음말

마크다운은 그 단순함과 강력함 덕분에 점점 더 많은 곳에서 사랑받고 있습니다.

처음에는 조금 낯설 수 있지만, 몇 가지 기본 문법만 익히면 누구나 쉽고 빠르게 문서를 작성하고 공유할 수 있습니다. 오늘 배운 내용을 바탕으로 여러분의 문서 작성 효율을 한층 높여보시길 바랍니다!

 

https://devblog.tistory.com/entry/%EC%B4%88%EB%B3%B4-%EA%B0%80%EC%9D%B4%EB%93%9C-%EC%98%B5%EC%8B%9C%EB%94%94%EC%95%88-%ED%94%8C%EB%9F%AC%EA%B7%B8%EC%9D%B8-Hello-World%EB%B6%80%ED%84%B0-%EC%8B%9C%EC%9E%91%ED%95%98%EA%B8%B0

[초보 가이드] 옵시디안 플러그인, 'Hello World'부터 시작하기