MD(Markdown) 파일은 글에 제목·강조·표·이미지·링크 등을 넣는 문서 형식입니다. 블로그 원고나 책 초고를 작성하기에 편합니다.

다만 어디에서 열거나 게시하느냐에 따라 지원되는 효과가 달라집니다. 같은 MD 파일도 GitHub, 블로그, 전자책 변환 도구에서 다르게 표시될 수 있습니다.

1. 기본적인 효과

제목 작성: # 제목, ## 소제목 용도: 글과 장·절 구분

굵게 작성: **중요한 내용** 용도: 중요한 내용

기울임 작성: *강조할 말* 용도: 강조할 말

취소선 작성: ~~삭제할 내용~~ 용도: 삭제할 내용

인용문 작성: > 인용할 문장 용도: 대사·인용·핵심 문장

구분선 작성: --- 용도: 장면이나 주제 전환

링크 작성: [사이트 이름](https://example.com) 용도: 다른 페이지로 연결

이미지 작성: ![그림 설명](그림주소) 용도: 표지·삽화·사진 삽입

코드 작성: 백틱으로 코드 감싸기 용도: 명령어나 코드 표시

표 작성: 세로줄로 열 구분 용도: 정보 비교·정리

취소선과 표는 확장 문법으로, 사용하는 프로그램의 지원이 필요합니다.

제목

작성 예:

# 큰 제목 ## 소제목 ### 작은 소제목

제목은 # 개수로 단계가 나뉘며, 일반적으로 6단계까지 사용할 수 있습니다.

인용문

작성 예:

> 진실은 늘 우리가 보고 싶지 않은 곳에 있었다.

표시 예시:

진실은 늘 우리가 보고 싶지 않은 곳에 있었다.

구분선

작성 예:

---

2. 목록과 체크리스트

작성 예:

- 첫 번째 항목 - 두 번째 항목

1. 첫 번째 순서 2. 두 번째 순서

- [x] 원고 작성 완료 - [ ] 삽화 추가

체크리스트는 지원되는 곳에서 체크박스로 표시됩니다. 직접 클릭해 상태를 바꿀 수 있는지는 프로그램마다 다릅니다.

3. 링크와 이미지

링크

작성 예:

[사이트 방문하기](https://example.com)

이미지

작성 예:

![책 표지 설명](images/cover.jpg)

이미지는 인터넷 주소 또는 상대 경로로 연결할 수 있습니다. MD 파일을 옮길 때 상대 경로로 연결한 이미지도 함께 옮겨야 합니다. MD 파일 하나에 이미지가 자동으로 포함되는 것은 아닙니다.

4. 프로그램 코드와 문법 강조

짧은 코드는 백틱으로 감쌉니다.

작성 예:

명령어는 `java -version`입니다.

여러 줄 코드는 백틱 3개로 감싸고 언어를 지정할 수 있습니다.

작성 예:

```java System.out.println("안녕하세요"); ```

표시 예시:

Java
System.out.println("안녕하세요");

지원되는 뷰어에서는 문법에 따라 색상이 붙습니다.

5. 표 작성

작성 예:

| 구분 | 설명 | |---|---| | 제목 | 장과 절 구분 | | 이미지 | 표지와 삽화 삽입 | | 링크 | 다른 페이지 연결 |

표는 정보를 비교하거나 정리할 때 유용합니다. 표 지원 여부와 모바일 화면에서의 표시는 사용하는 프로그램에 따라 달라집니다.

6. 추가로 가능한 효과

접기·펼치기 작성: HTML의 <details> 주의: HTML 허용 필요

글자색·배경색 작성: HTML과 CSS 주의: 블로그에서 차단할 수 있음

수식 작성: LaTeX 문법 주의: 수식 렌더러 필요

흐름도·관계도 작성: Mermaid 문법 주의: Mermaid 지원 필요

각주 작성: [^1] 주의: 각주 지원 필요

자동 목차 작성: 제목을 기준으로 생성 주의: 게시 도구의 기능 필요

동영상·음악 작성: HTML 또는 서비스 임베드 주의: 플랫폼마다 제한이 다름

접기·펼치기: 스포일러 숨기기

작성 예:

<details> <summary>스포일러 보기</summary> 이 안에 결말이나 반전 내용을 작성합니다. </details>

HTML을 허용하는 환경에서는 내용을 접어둘 수 있습니다. 일부 플랫폼에서는 내부 Markdown이 제대로 표시되지 않을 수 있습니다.

글자색과 배경색

작성 예:

<span style="color: red;">빨간 글씨</span> <span style="background-color: yellow;">노란 배경 강조</span>

표준 Markdown 문법은 아닙니다. HTML과 인라인 스타일을 허용하는 환경에서만 적용됩니다.

수식

작성 예:

인라인 수식: $E = mc^2$

블록 수식: $$ a^2 + b^2 = c^2 $$

수식 렌더러가 필요하며, 구분 문법도 플랫폼마다 다를 수 있습니다.

흐름도·관계도

작성 예:

```mermaid flowchart TD A[사건 발생] --> B{단서 확인} B -->|알리바이| C[목격자 조사] B -->|물증| D[현장 분석] C --> E[추리 정리] D --> E ```

Mermaid를 지원하는 환경에서는 위 코드를 도식으로 표시합니다.

각주

작성 예:

이 문장에는 보충 설명이 있습니다.[^1]

[^1]: 본문 아래에 표시할 보충 설명입니다.

각주를 지원하는 환경에서 사용할 수 있습니다.

자동 목차

자동 목차는 표준 Markdown 자체의 기능이 아닙니다. 일부 프로그램에서는 제목을 바탕으로 자동 생성하거나 [TOC] 같은 문법을 지원합니다.

7. 블로그와 소설에 활용하기

블로그 글과 소설을 작성할 때는 제목, 삽화, 인용문, 구분선, 각주를 활용하면 좋습니다.

- 제목: 장과 절을 나누고 글의 구조를 정리합니다. - 삽화: 장면의 분위기나 인물을 시각적으로 전달합니다. - 인용문: 핵심 문장이나 인용 내용을 강조합니다. - 구분선: 시간·장소·시점이 바뀌는 지점을 표시합니다. - 각주: 본문 흐름을 유지하면서 보충 설명을 제공합니다. - 접기·펼치기: 리뷰에서 스포일러를 숨기는 데 활용합니다.

글꼴·글자 크기·줄간격·배경·애니메이션 같은 디자인은 보통 MD를 보여주는 사이트의 CSS나 테마에서 설정합니다. 전자책이나 PDF로 변환할 때도 변환 도구와 스타일 설정에 따라 결과가 달라집니다.