마크다운 ↔ HTML 변환은 언제 쓰나요
마크다운은 #, ** 같은 기호로 제목과 굵은 글씨를 표시하는 간단한 글쓰기 방식입니다. 메모 앱이나 개발 문서에서 마크다운으로 써 둔 글을 블로그의 HTML 편집기로 옮기고 싶을 때, 반대로 HTML로 된 글을 마크다운 문서로 옮기고 싶을 때 이 기능을 씁니다. 변환은 브라우저 안에서 바로 이루어집니다.
위의 "마크다운 변환 창 열기" 버튼을 누르면 창이 열리고, 위쪽에 탭이 두 개 있습니다.
- HTML → Markdown 변환: 지금 편집기 왼쪽 소스 코드 창에 있는 HTML 전체를 마크다운으로 바꿔 아래 칸에 보여 줍니다. "마크다운 복사하기" 버튼으로 복사합니다.
- Markdown → HTML 변환: 칸에 마크다운을 붙여 넣고 "에디터 본문에 HTML로 삽입"을 누르면, HTML로 바꿔 비주얼 편집 화면의 커서 위치에 끼워 넣습니다. 기존 글을 지우지 않고 그 자리에 더해집니다.
마크다운을 HTML로 바꿀 때 지원하는 문법
이 도구는 아래 표에 있는 문법만 바꿉니다. 기호 뒤에 띄어쓰기 한 칸이 있어야 하는 문법이 있으니 표의 모양 그대로 써 주세요.
| 쓰는 법 | 바뀌는 결과 | 조건 |
|---|---|---|
# 제목 ~ #### 제목 | 제목 1~4단계 | 줄 맨 앞, # 뒤에 한 칸 띄움 |
**굵게** | 굵은 글씨 | 한 줄 안에서 |
*기울임* | 기울임 글씨 | 한 줄 안에서 |
[글자](주소) | 링크 | 대괄호와 괄호를 붙여 씀 |
> 인용문 | 인용 상자 | 줄 맨 앞, > 뒤에 한 칸 띄움 |
- 항목 | 점 목록(<ul>) | 줄 맨 앞, - 뒤에 한 칸 띄움 |
1. 항목 | 번호 목록(<ol>) | 줄 맨 앞, 숫자와 점 뒤에 한 칸 |
 | 그림 | 설명은 그림의 대체 글이 됨 |
`코드` | 한 줄 코드 | 백틱으로 감쌈 |
| 빈 줄 하나 | 문단 나누기 | 줄바꿈 두 번 |
| 줄바꿈 한 번 | 줄바꿈(<br>) |
변환 예시
마크다운으로 이렇게 넣으면
아래와 같은 HTML이 됩니다.
지원하지 않는 문법
아래 문법은 바꾸지 않고 기호가 그대로 글자로 남습니다. 넣기 전에 필요한 부분은 편집기에서 직접 다듬어 주세요.
- 별표 목록
* 항목: 목록이 되지 않습니다. 점 목록은- 항목으로 쓰세요. - 들여쓴 목록(목록 안의 목록): 한 단계 목록으로만 바뀝니다.
- 표
| 칸 | 칸 |: 표가 되지 않습니다. 표는 엑셀·구글 시트 표 HTML 변환에서 만드는 편이 빠릅니다. - 코드 블록(
```), 취소선(~~), 5~6단계 제목, 구분선은 바꾸지 않습니다.
<p>)으로 감싸지지 않고 줄바꿈으로만 이어집니다. 제목과 본문 사이에는 빈 줄을 하나 두는 것이 좋습니다. 넣은 뒤에는 왼쪽 소스 코드 창에서 결과를 한 번 확인하세요.여러 문법이 섞인 예시
위 마크다운은 <h1>제목</h1><ul><li>하나</li><li>둘</li></ul><ol><li>첫째</li><li>둘째</li></ol>가 됩니다.
HTML을 마크다운으로 바꿀 때
HTML → Markdown 탭은 아래 태그를 마크다운 기호로 바꾸고, 나머지 태그는 모두 지운 뒤 안의 글자만 남깁니다.
- 제목 1~4단계 →
#~#### - 굵게(
<strong>,<b>) →**글자**, 기울임(<em>,<i>) →*글자* - 링크 →
[글자](주소), 그림 → - 인용 →
> 글, 목록 항목 →- 항목(번호 목록도-로 바뀝니다), 문단 → 빈 줄로 구분
변환 예시
위 HTML은 아래 마크다운이 됩니다.
이런 경우는 그대로 바뀌지 않습니다
- 굵게·기울임 태그에 색상 같은 속성이 붙어 있으면(
<strong style="...">) 기호로 바뀌지 않고 글자만 남습니다. - 한 태그의 내용이 여러 줄에 걸쳐 있으면 그 부분은 기호로 바뀌지 않고 글자만 남습니다.
- 표는 칸 구분 없이 글자만 이어 붙어 남습니다. 코드 블록도 기호 없이 글자만 남습니다.
&같은 특수문자 코드는 원래 글자로 풀지 않고 그대로 남습니다. 필요하면 HTML 특수문자 변환으로 먼저 풀어 주세요.- 그림 태그는 주소(src)가 설명(alt)보다 앞에 있을 때만 설명이 함께 옮겨집니다. 순서가 반대면 설명 없이 주소만 남습니다.
결과를 넣고 복사하는 순서
- HTML을 마크다운으로: 소스 코드 창에 HTML을 넣고 변환 창을 열면 첫 탭에 결과가 나옵니다. "마크다운 복사하기"를 눌러 원하는 곳에 붙여 넣습니다.
- 마크다운을 HTML로: 비주얼 편집 화면에서 넣을 자리를 한 번 클릭해 커서를 둡니다. 변환 창의 둘째 탭에 마크다운을 붙여 넣고 "에디터 본문에 HTML로 삽입"을 누릅니다.
- 넣은 뒤 소스 코드 창에서 결과를 확인하고, 블로그에 옮길 때는 소스 코드를 복사해 블로그의 HTML 편집 모드에 붙여 넣습니다.
자주 묻는 질문
표와 코드 블록도 바꿀 수 있나요?
아니요. 이 도구는 제목, 굵게, 기울임, 링크, 그림, 한 줄 코드, 인용, 목록, 문단과 줄바꿈만 바꿉니다. 표는 표 변환 기능을 쓰고, 여러 줄 코드는 특수문자 변환으로 처리하세요.
변환하면 기존 글이 지워지나요?
마크다운을 HTML로 넣을 때는 커서 위치에 더해지고 기존 글은 남습니다. HTML을 마크다운으로 바꾸는 탭은 결과만 보여 주고 편집기 글은 바꾸지 않습니다.
목록이 두 개로 나뉘어 나옵니다.
목록 항목 사이에 빈 줄이 있으면 목록이 끊긴 것으로 보고 따로 만듭니다. 한 목록으로 묶으려면 항목을 빈 줄 없이 이어서 쓰세요.
그림이 보이지 않습니다.
그림 주소가 인터넷에서 바로 열리는 주소인지 확인하세요. 내 컴퓨터에 있는 파일 경로는 블로그에서 보이지 않습니다. 블로그에는 그림을 먼저 올린 뒤 그 주소를 쓰세요.