잡동사니 보석함

the Web & Scripts

티스토리 마크다운 문법

2020. 11. 13.

2019년 3월 공개된 티스토리의 새 에디터는 마크다운 모드를 지원합니다. 빠른 글쓰기와 깔끔한 결과물 때문에 마크다운 에디터를 선호하기에 반가운 소식이었습니다. 안타깝게도 기능 부족과 버그 때문에 아직 단독으로 사용할 만큼 완성도가 높지는 않다고 생각하지만, 간단한 글이나 초안을 작성하는 용도로는 사용할만합니다.

티스토리 공지에 마크다운을 설명하는 페이지가 있습니다만, 공식 가이드가 아닌 건지 업데이트가 안 된 건지 실제 에디터와 100% 호환되지 않았습니다. 실제 마크다운 모드를 사용하며 자주 쓰는 문법을 정리해봤습니다.

참고로 티스토리 마크다운 에디터에서는 html 태그도 함께 사용할 수 있습니다.

단락과 서식

단락과 제목, 강조 등 일반적인 서식은 흔하게 사용하는 방식 그대로 적용되어 있습니다.

단락 구분

줄 바꿈을 두 번 하면 P 태그, 한 번 하면 BR 태그로 치환됩니다.

1: 첫째 줄과
2:
3: 둘째 줄 사이에 두 번의 줄 바꿈
4: 마지막엔 한 번만 줄 바꿈

제목

문장 앞에 # 개수에 따라 h1 ~ h6까지 치환됩니다.

# h1로 치환
## h2로 치환
### h3로 치환
#### h4로 치환
##### h5로 치환
###### h6로 치환

※ 마크(#)와 문장 사이에 반드시 공백을 넣어야 합니다.

강조, 기울임, 취소선

적용할 문장 앞뒤에 다음 기호를 넣으면 각 항목으로 치환됩니다.

**강조(볼드체)** 혹은 __강조(볼드체)__
*기울임(이탤릭체)* 혹은 _기울임(이탤릭체)_
~취소선~

여러가지를 한번에 적용하고 싶다면 해당 마크를 연달아 쓰면 됩니다. 예를 들어, 두꺼운 이탤릭체에 취소선까지 긋고 싶다면, 다음처럼 사용하면 됩니다.

***~볼드, 이탤릭, 취소선이 모두 적용~***

※ 마크(*, _, ~)와 문장 사이에 공백이 없어야 합니다.

블럭

리스트와 코드 블럭 사용 문법이 독특합니다.

리스트

1.은 ol로 치환, * + -는 ul로 치환됩니다. 한 단계 들여 쓰려면 앞에 공백 2칸 추가해야 합니다.

* 목록 불릿은
  * 속이 찬
    * 검은 동그라미
1. 일 이외의
1. 숫자를
  1. 사용해도 무방

※ 마크(*, +, - 1.)와 문장 사이에 반드시 공백을 넣어야 합니다.

인용문

문장 앞에 꺾쇠(>) 사용시 인용문으로 치환되고, 한 단계 들여 쓰려면 꺾쇠를 하나 더 추가하면 됩니다.

> 여러 줄을 연달아 쓰면
>> 하나의 인용문으로 처리된다
>>> 꺾쇠만 쓰면 인용문 내 빈 줄로 처리
>
> 전 단계로 돌아가려면 빈 줄이 필요

코드블럭

적용할 문장 앞뒤에 그레이브(`)를 넣으면 치환됩니다. 다른 에디터 모드와 잘 호환되지 않으니 주의해야 합니다.

`한 개 이상 써도 작동한다`
```
그레이브 3개와 줄바꿈을 함께 사용하면
pre 태그가 추가된다
```

삽입

이미지와 링크, 수평선 추가는 대체로 기존 방식과 유사합니다.

이미지

![대체텍스트](이미지 주소) 형태로 사용합니다. 대체 텍스트 자체는 생략할 수 있지만, 구문인 브래킷([])은 반드시 포함해야 합니다.

![태극기](http://finance.daum.net/images/flag/KOR.png)
![](http://finance.daum.net/images/flag/KOR.png)

링크

[표시할 텍스트](사이트 주소) 형태로 사용합니다. 프로토콜 부분(http://, https://)도 반드시 기입해야 합니다. 생략시 에디터에서는 링크되는 것처럼 보이지만, 발행하면 링크되지 않습니다.

대체 텍스트를 사용하지 않고 주소를 그냥 보이고 싶을 때는 주소만 적으면 자동으로 링크됩니다. 좀 더 흔한 방식인 꺽쇠를 사용해도 작동합니다.

[다음 금융](http://finance.daum.net)
http://finance.daum.net

내부 링크에는 첫번째 방식만 사용할 수 있고, 이메일 링크(mailto)는 두번째 주소를 직접 적어주는 방식만 가능합니다.

[내부 링크](#flag)
nobody@email_example.com

수평선

공백을 무시하고 *이나 -가 3번 이상 연속으로 오면 치환됩니다. 어느쪽을 사용해도 출력되는 수평선 종류는 동일합니다.

*** 혹은 * * *
--- 혹은 - - -

참고 문서

썸네일 이미지 : 하기 1번 마크다운 가이드 사이트마크다운 소개 페이지 캡처

  1. 마크다운 가이드 : www.markdownguide.org/basic-syntax
  2. 티스토리 공지 : notice.tistory.com/2478
1 2 3 4 5 6 7 8 9