본문 바로가기
카테고리 없음

자주 사용하는 마크다운 문법(Markdown Syntax)

by 왕 달팽이 2019. 7. 1.
반응형

프로그래머로 일하면서 다양한 협업툴을 사용하게 된다. 그 중에 깃허브(Github)와 관련된 툴을 사용하는 경우 '마크다운(Markdown)'이라는 언어를 사용하게 되는 경우가 많이 있다.
깃허브 이슈라든지 '풀 리퀘스트(Pull Request)' 요청시 요청 사항을 기술하기 위해서 마크다운을 많이 사용한다.

마크다운(Markdown)이란?

마크다운은 HTML, XML과 같은 마크업 언어의 일종이다. 2004년 '존 그루버'와 '에런 스워츠'가 협업을 통해 만들어낸 언어이며, 사람들이 읽기 쉽고 쓰기 쉬운 플레인 텍스트(Plain Text) 포맷을 사용하여 작성할 수 있다. XHTML, HTML 등으로 쉽게 변환이 가능한 것이 특징이다.

최근 티스토리의 새로운 에디터가 적용되면서 티스토리 글도 마크다운으로 작성할 수 있게 되었다.

마크다운(Markdown)의 장점

마크다운의 장점은 다음과 같다.

  • 쓰기 쉽다
  • 다른 포맷으로 쉽게 변형할 수 있다.
  • 지원 가능한 플랫폼과 프로그램이 다양하다.

마크다운의 가장 큰 장점은 역시나 쓰기 쉽다는 점이다. 물론 다양한 문법과 기능, 포매팅이 지원되지만 많이 사용하는 문법 몇 개만 알고 있으면 마크 다운을 사용하는데 큰 불편함은 없을 것이다.

사용하기 쉽기때문에 쓰고자하는 컨텐츠 자체에 집중할 수 있다.

마크다운(Markdown)의 단점

마크다운의 단점은 다음과 같다.

  • 표준이 없다
  • 모든 HTML 마크업을 지원하지는 않는다

마크다운은 표준이 없기 때문에 사용하는 환경에 따라 렌더링된 결과 화면이 다르거나 다른 형태로 확장된 경우가 많이 있다. 따라서 사용처에 따라 상세한 문법이 달라 헷갈리는 경우가 있다.

자주 사용하는 마크다운 문법

자주사용하는 마크다운 문법을 정리해보자.

제목

마크다운에서는 6단계의 제목을 표현할 수 있다. HTML에서 <h1>, <h2>, ... <h6> 태그에 해당한다고 생각하면 된다. # 개수에 따라서 <h1> .. <h6>처럼 제목의 크기가 결정된다.

# 첫 번째
## 두 번째
### 세 번째 
#### 네 번째
##### 다섯 번째
###### 여섯 번째

이 마크다운은 다음과 같이 보인다.

첫 번째

두 번째

세 번째

네 번째

다섯 번째
여섯 번째

이 중 가장 큰 제목과 두 번째로 큰 제목(<h1>, <h2>)은 다음과 같이 표현할 수도 있다.

첫 번째 제목
========

은 다음과 같이 렌더링된다.

첫 번째 제목

두 번째 제목
--------

은 다음과 같이 렌더링 된다.

두 번째 제목

강조 혹은 취소선

글자의 강조 혹은 취소선은 다음과 같이 사용할 수 있다.

*기울임*
_기울임_
**굵게**
__굵게__
~~취소선~~
<u>밑줄</u>

이는 다음과 같이 렌더링 된다.

기울임
기울임
굵게
굵게
취소선
밑줄

인용

> 첫번째 단계 인용
>> 두번째 단계 인용

첫번째 단계 인용

두번째 단계 인용

목록 - 순서가 있는 목록

1. 항목1
2. 항목2
2. 항목3
4. 항목4

번호의 순서는 중요하지 않다

  1. 항목1
  2. 항목2
  3. 항목3
  4. 항목4

목록 - 순서가 없는 목록

- 항목1
+ 항목2
    * 항목 2-1
    + 항목 2-2
* 항목3
* 항목4

*, +, - 문자를 앞에 붙이면 순서가 없는 목록으로 인식한다.

  • 항목1
  • 항목2
    • 항목 2-1
    • 항목 2-2
  • 항목3
  • 항목4

수평선

수평선
***
수평선
___

세 가지 문자중 하나를 3번 반복하면 수평선을 사용할 수 있다.

수평선2


수평선3


링크

[네이버](https://www.naver.com)
[블로그](https://dev.feeden.net "블로그로 이동")
<www.google.com>

네이버
블로그

이미지

![이미지 대체 설명](https://cdn.pixabay.com/photo/2019/06/25/04/40/light-4297386__480.jpg "출처 :pixabay.com")

이미지 대체 설명

소스코드

``인라인`` 코드 강조

인라인 코드 강조


혹은 3개의 \` 문자를 사용하면 블록 단위로 코드를 넣을 수 있다. 특히 ```bash 혹은 ```java 처럼 첫 번째 ```에 어떤 소스코드인지를 명시하면 하이라이팅을 해주기도 한다.

테이블

| 값1 | 값2 | 값3 |
|---|:---:|---:|
|행1 |컬럼1-1 | 컬럼1-2 |
|행2 |컬럼2-1 | 컬럼2-2 |
|행3 |컬럼3-1 | 컬럼3-2 |

테이블을 그리는 첫 번째 줄은 헤더 셀이 된다. 두 번째 줄에서 콜론(':') 문자로 정렬을 명시할 수 있다. 가장 왼쪽과 오른쪽에 있는 '|' 문자는 생략할 수 있다.

값1 값2 값3
행1 컬럼1-1 컬럼1-2
행2 컬럼2-1 컬럼2-2
행3 컬럼3-1 컬럼3-2

HTML

마크다운은 간단한 HTML 태그를 지원한다

마크다운은 HTML을 <br> 지원하기도 한다. 따라서 필요한 곳에 <em>적절하게</em> 태그를 불러다 사용하면 된다, 

마크다운은 HTML을
지원하기도 한다. 따라서 필요한 곳에 적절하게 태그를 불러다 사용하면 된다,

마치며

마크다운의 상세한 문법은 사용처에 따라 다를 수 있으니 유의해서 잘 사용하기 바란다.

반응형

댓글