[Markdown] 마크다운 사용방법

워네·2022년 5월 6일
Markdown
0

👾 개발지식

목록 보기
1/1
post-thumbnail

마크다운(Markdown)

마크다운이란?

일반 텍스트 기반의 경량 마크업 언어다. 일반 텍스트로 서식이 있는 문서를 작성하는 데 사용되며, 일반 마크업 언어에 비해 문법이 쉽고 간단한 것이 특징이다. HTML과 리치 텍스트(RTF) 등 서식 문서로 쉽게 변환되기 때문에 응용 소프트웨어와 함께 배포되는 README 파일이나 온라인 게시물 등에 많이 사용된다.

  • 쉽게 읽을 수 있고, 쉽게 작성할 수 있게 만들어짐
  • 가독성이 제일 중요함
  • 웹상에서 사용할 수 있는 글쓰기 도구
  • 모든 HTML 마크업을 대체하지는 않음

📌 Block Elements

📖 제목(headers) 넣어보기

h1부터 h6를 이용해서 제목을 표현할 수 있다.

참고 : 회색 박스로 감싸진 부분은 백틱(backtick)(``)으로 감싸서 작성하면 된다.

✍ 입력

# 첫 번째 수준 제목 (h1)
## 두 번째 수준 제목 (h2)
### 세 번째 수준 제목 (h3)
#### 네 번째 수준 제목 (h4)
##### 다섯 번째 수준 제목 (h5)
###### 여섯 번째 수준 제목 (h6)

💻 출력

첫 번째 수준 제목 (h1)

두 번째 수준 제목 (h2)

세 번째 수준 제목 (h3)

네 번째 수준 제목 (h4)

다섯 번째 수준 제목 (h5)
여섯 번째 수준 제목 (h6)

📖 인용(Blockquotes)

본문 안에서 인용된 내용을 표시하고자 한다면 > 기호를 사용한다.

✍ 입력

> # 1단
인용문 첫 번째 줄
인용문 두 번째 줄
인용문 세 번째 줄
>> ## 2단
중복해서 사용하면
>>> ### 3단
중첩 인용문을 표현할 수 있다.
>>>> #### 4단
계속 중첩할 수 있다.

참고: 인용문 안에서 제목 수준을 표현할 수도 있다.

💻 출력

1단

인용문 첫 번째 줄
인용문 두 번째 줄
인용문 세 번째 줄

2단

중복해서 사용하면

3단

중첩 인용문을 표현할 수 있다.

4단

계속 중첩할 수 있다.

📖 리스트

일반적인 불릿 리스트는 * + - 중 아무 기호나 이용하면 된다.

✍ 입력

* 별도
+ 플러스도
- 마이너스도 똑같이 나온다.

💻 출력

  • 별도
  • 플러스도
  • 마이너스도 똑같이 나온다.

숫자 리스트는 숫자 + 마침표를 이용하면 된다.

✍ 입력

1. 1번
2. 2번
6. 3번
3. 4번
4. 5번

💻 출력

  1. 1번
  2. 2번
  3. 3번
  4. 4번
  5. 5번

참고: 숫자 리스트는 순서가 맞지 않아도 자동으로 순서가 맞춰진다.

리스트 안에서 이어지는 문단을 추가할 때는 스페이스바만 입력해줘도 된다.

✍ 입력

- 첫 번째 리스트

 이어지는 두 번째 문단
 
- 두 번째 리스트

 이어지는 두 번째 문단

💻 출력

  • 첫 번째 리스트

    이어지는 두 번째 문단

  • 두 번째 리스트

    이어지는 두 번째 문단

📖 코드블럭(Code Blocks) 만들어보기

한 줄짜리 코드블럭은 Tab을 이용해서 작성할 수 있다.

다만, 이전 문장으로부터 엔터를 두 번 입력해야만 가능하다.

여러 줄의 코드 블럭은 백틱(``) 3개로 감싸서 작성한다.

여러 줄의 코드 블럭은
3개의 백틱으로
감싸서 만들 수 있다

✍ 입력

```c
#include <stdio.h>

int main()
{
	printf("Hello, world!\n");

	return 0;
} ```

💻 출력

#include <stdio.h>

int main()
{
	printf("Hello, world!\n");

	return 0;
}

📖 가로선 넣기

가로선을 넣기 위한 다양한 방법이 있는데, 아래의 입력 방식은 모두 동일한 가로선을 만들어준다.

✍ 입력

* * *
***
*****
- - -
---
-----
_ _ _
___
_____

💻 출력

📌 Span Elements

📖 링크 서식(Links)

아래 3가지 방식으로 링크를 나타낼 수 있다.

  1. 인라인 링크
  2. url 링크
  3. 참조 링크

✍ 입력

인라인 링크
[인라인 링크](https://velog.io/)

url 링크
<https://velog.io/>

참조 링크
[velog]:https://velog.io/

[velog]

💻 출력

인라인 링크

https://velog.io/

velog <- 키워드를 참조하는 방식

📖 강조하기(Emphasis)

볼드, 이탤릭, 취소선을 사용할 수 있다.

✍ 입력

*이탤릭*
_이탤릭_
**볼드**
__볼드__
~~취소선~~

💻 출력

이탤릭
이탤릭
볼드
볼드
취소선

📖 이미지 삽입(Images)

링크 삽입 방식과 유사하나, 맨 앞에 !를 붙인다.

✍ 입력

1. 일반 이미지 삽입하기: ![대체 텍스트](이미지 링크)
예시: ![CloudScape](https://cdn.pixabay.com/photo/2019/03/13/08/29/cat-4052454_1280.jpg)

2. 이미지에 설명 삽입하기: ![대체 텍스트](이미지 링크 "이미지 설명 문구")
예시: ![CloudScape](https://cdn.pixabay.com/photo/2019/03/13/08/29/cat-4052454_1280.jpg "Cloudy Sky")
** 참고: 이미지에 마우스를 올렸을 때 나타나는 설명을 의미함

3. 이미지에 링크 걸기: [![대체 텍스트](이미지 링크)](연결할 url "url 설명 문구")
예시: [![CloudScape](https://cdn.pixabay.com/photo/2019/03/13/08/29/cat-4052454_1280.jpg)](https://cdn.pixabay.com/photo/2019/03/13/08/29/cat-4052454_1280.jpg "Pixabay Image")

💻 출력

  1. 일반 이미지 삽입예시 :
  2. 이미지에 설명 삽입 예시 :
  3. 이미지에 링크 예시 :

📌 MISCELLANEOUS

📖 기호 표시(Backslash Escapes)

마크다운 문법에 있는 기호를 그대로 출력하고 싶다면, 역방향 슬래시를 앞에 붙여주면 된다.

✍ 입력

\*
\_
\()
\{}
\[]
\#
\+
\-
\.
\!
\\

💻 출력

*
_
()
{}
[]
#
+
-
.
!
\

📖 테이블(Table)

  • 수직선 기호(|)로 열을 구분할 수 있다.
  • 하이픈 기호(-)를 여러 개 붙여서 th와 tr을 구분할 수 있다.
  • 콜론 기호(:)로 정렬을 표현할 수 있다.

✍ 입력

|    |left |center|right
|----|:----|:----:|----:
|row1|l1   |  c1  |   r1
|row2|l2   |  c2  |   r2
|row3|l3   |  c3  |   r3

📖 이모지(Emoji)

  1. 링크에서 복사+붙여넣기 : https://kr.piliapp.com/twitter-symbols/
  2. 단축키 이용 :
    • windows: 윈도우 키 + 마침표(.)
    • mac: Command + Control + Space Bar

📖 체크박스(Check Box)

*, +, - 기호 뒤에 띄어쓰기 이후 대괄호[]를 넣어 작성한다.
띄어쓰기를 하면 체크되지 않은 상태이고, x를 입력해주면 체크된 상태가 된다.

✍ 입력

- [ ] 체크되지 않은 박스
- [x] 체크된 박스

💻 출력

  • 체크되지 않은 박스
  • 체크된 박스
profile
워네
front-end developer 🐣

0개의 댓글