마크다운이란

마크다운(markdown)은 일반 텍스트 문서의 양식을 편집하는 문법이다. README 파일이나 온라인 문서, 혹은 일반 텍스트 편집기로 문서 양식을 편집할 때 쓰인다. 마크다운을 이용해 작성된 문서는 쉽게 HTML 등 다른 문서형태로 변환이 가능하다.
-위키백과

📖마크다운 작성법

1. 제목(header)

h1부터 h6까지 표현할 수 있으며, # 의 개수로 표현 가능합니다.

✍ 마크다운 작성 시

# h1
## h2
### h3
#### h4
##### h5
###### h6

👉 결과

h1

h2

h3

h4

h5
h6

🧐 h1과 h2는 이렇게도 작성 가능해요.

=, -를 각각 2개 이상 사용하면 아래와 같이 h1, h2#을 대체할 수 있습니다.
여러 개를 사용해도 마찬가지예요.

✍ 마크다운 작성 시

h1
==
h2
--

하이픈을 여러 개 사용한 제목
----------

👉 결과

h1

h2

하이픈을 여러 개 사용한 제목

2. 문단 간격

문단의 간격은 줄 바꿈으로 나타내며, 여러 번 줄 바꿈을 해도 동일하게 한 번만 적용됩니다.

✍ 마크다운 작성 시

첫 번째 문단



두 번째 문단

👉 결과

첫 번째 문단

두 번째 문단

3. 목록

순서를 표기하는 목록 / 순서가 없는 목록 두 가지를 작성할 수 있습니다.

3.1 순서를 표기하는 목록

숫자.을 사용하여 작성합니다.

✍ 마크다운 작성 시

1. 첫 번째
2. 두 번째
3. 세 번째

👉 결과

  1. 첫 번째
  2. 두 번째
  3. 세 번째

3.2 순서가 없는 목록

-, *, + 을 사용 하여 작성합니다. (셋 다 동일하게 작성됩니다.)
인라인 코드, 블럭 코드를 작성할 수 있으며 Tab키나 스페이스 바를 이용해 들여쓰기가 가능합니다.

✍ 마크다운 작성 시

- 순서 없는 목록 1
    - 목록 1.1
        - 목록 1.2
- 순서 없는 목록 2

        Tab 두번 하면 코드 블럭을 만들 수 있어요.
* 순서 없는 목록 3
+ 순서 없는 목록 4
    + `인라인 코드 가능`
        + 들여쓰기(tab키 이용)를 하면 다른 모양으로 표현 됩니다.

        ``` 
        블럭 코드 가능
        ``` 

👉 결과

  • 순서 없는 목록 1

    • 목록 1.1
      • 목록 1.2
  • 순서 없는 목록 2

      Tab 두번 하면 코드 블럭을 만들 수 있어요.
  • 순서 없는 목록 3
  • 순서 없는 목록 4

    • 인라인 코드 가능

      • 들여쓰기(tab키 이용)를 하면 다른 모양으로 표현 됩니다.

        블럭 코드 가능

4. 폰트 스타일

굵게, 기울이기, 취소선 등 기본적인 스타일을 아래와 같이 작성할 수 있습니다.

✍ 마크다운 작성 시

__굵게__
**굵게**
_기울여 쓰기_
*기울여 쓰기*
~취소선~
~~취소선~~

👉 결과

굵게
굵게
기울여 쓰기
기울여 쓰기
취소선
취소선

5. 인용문

인용문을 작성할 때에는 >를 사용합니다.

✍ 마크다운 작성 시

> 인용문 작성하기
-작성자

> 인용문 작성하기
>> (>)의 갯수에 따라
>>> 중첩문 가능

👉 결과

인용문 작성하기
-작성자

인용문 작성하기

>의 갯수에 따라

중첩문 가능

6. 인라인 코드

백틱(`)을 사용하여 인라인 코드를 작성할 수 있습니다.

✍ 마크다운 작성 시

`인라인 코드는 이렇게 작성해요.`

👉 결과

인라인 코드는 이렇게 작성해요.

7. 여러 줄로 된 코드 블럭

백틱(`)을 세 개 사용하여 작성할 수 있습니다.

✍ 마크다운 작성 시

``` 
위 아래 3개로 감싸면 블럭으로 만들 수 있어요.
``` 

👉 결과

위 아래 3개로 감싸면 블럭으로 만들 수 있어요.

🧐 코드 하이라이트

✍ 마크다운 작성 시

```아래와 같이 백틱 3개 뒤에 언어 이름을 넣어주세요.

```javascript
let sumNumbers = (firstNum, lastNum) => {
  return firstNum + lastNum;
};
sumNumbers(100, 200);
``` 

```python
num_list = ['one', 'two', 'three']
for num in num_list:
  print(num)
``` 

👉 결과

let sumNumbers = (firstNum, lastNum) => {
  return firstNum + lastNum;
};
sumNumbers(100, 200);
num_list = ['one', 'two', 'three']
for num in num_list:
  print(num)

🎨 코드 블럭 색 변경

(+ 2019-09-26 추가)

코드블럭변경.png

작성하기 클릭 ➜ 추가설정 ➜ 코드블록 테마 선택 에서 변경하실 수 있습니다.

인라인 링크와 url 링크, 참조 링크로 나타낼 수 있습니다.

✍ 마크다운 작성 시

인라인 링크는 아래처럼
[인라인 링크](https://velog.io/)

url 링크는 아래처럼
<https://velog.io/>

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

👉 결과

인라인 링크는 아래처럼
velog

url 링크는 아래처럼
https://velog.io/

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

9. 수평선

*이나 -, _ 등을 3개 이상 입력하면 작성할 수 있습니다.
띄어쓰기를 중간에 삽입하여도 가능합니다. 다만, 하이픈-은 헤더로 인식할 수도 있으니 주의해서 사용할 필요가 있습니다.

✍ 마크다운 작성 시

***
-----
__ __ __ __ __ __ __

👉 결과




10. 이미지 링크

이미지 링크는 아래와 같이 작성할 수 있습니다.

✍ 마크다운 작성 시

![이미지 설명](이미지 링크)
![고양이애옹](https://cdn.pixabay.com/photo/2019/03/13/08/29/cat-4052454_1280.jpg)

👉 결과

고양이애옹

만약 이미지에 링크를 걸고 싶을 경우에는 아래와 같이 작성합니다.

✍ 마크다운 작성 시

[![이미지 설명](이미지 링크)](연결하고자하는 url "마우스 오버 시 나타낼 링크 title")
[![고양이애옹](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")

👉 결과

고양이애옹

(+ 2019-10-03 추가)

이미지 크기는 10MB 이하만 가능합니다. (gif 포함)
사이즈 조절과 관련된 마크다운은 아직 적용이 되어있지 않은 것 같아요🙂

11. 테이블(Table)

테이블은 아래와 같이 작성합니다.
| 로 구분하며, <4. 폰트 스타일> 에서 이야기 했던 기본적인 스타일 적용이 가능합니다. 또한 -(하이픈)으로 구분된 곳 각각 왼쪽, 양쪽, 오른쪽에 :(세미콜론)을 붙일 경우 순서대로 왼쪽 정렬, 가운데 정렬, 오른쪽 정렬이 가능합니다.

✍ 마크다운 작성 시

| 드라마 제목 | 주연 배우 | 방영일 |
|:----------|:----------:|----------:|
| **호텔 델루나** | 이지은, 여진구 | ~*2019.07.13. ~ 2019.09.01.*~ |
| 타인은 지옥이다 | 임시완, 이동욱, 이현욱, 이정은 | 2019.08.31. ~ |
| 멜로가 체질 | 천우희, 안재홍, 전여빈, 공명 | 2019.08.09. ~ |

👉 결과

드라마 제목 주연 배우 방영일
호텔 델루나 이지은, 여진구 2019.07.13. ~ 2019.09.01.
타인은 지옥이다 임시완, 이동욱, 이현욱, 이정은 2019.08.31. ~
멜로가 체질 천우희, 안재홍, 전여빈, 공명 2019.08.09. ~

12. 체크박스(Check Box)

-, *, + 뒤에 띄어쓰기 후 대괄호를 넣어 작성해주세요. 대괄호안에 띄어쓰기를 하면 빈 체크박스, x를 넣으면 체크된 체크박스가 생깁니다.

✍ 마크다운 작성 시

- [ ] 운동 하기
- [x] 강의 듣기

👉 결과

  • 운동 하기
  • 강의 듣기

흰배경.png

13. 이모지🤗

(+ 2019-09-26 추가)

작성된 글 중간중간에 보이는 이모지는 트위터 이모지입니다.
https://kr.piliapp.com/twitter-symbols/
아래 주소의 트위터 이모지를 복사 ➜ 붙여넣기 해서 사용하시면 됩니다.

단축키

window10: 윈도우 키 + 마침표(.)
mac: Command + Control + 스페이스 바

마치며

velog를 하면서 처음 마크다운을 작성해 보았습니다. velog에서 적용이 되는 문법도 있고, 그렇지 않은 문법도 있어 앞으로 글을 쓰려면 정리된 마크다운 작성법이 있으면 좋을 것 같았어요.🙂❕

(결국은 내가 보려고 만드는 작성법...👶)

가장 기초적인! 문법들을 테스트해 보며 가능한 것들만 작성했습니다. 여기 적혀 있지 않은 다른 문법이 있다면 댓글로 남겨주시면 감사하겠습니다.😊

✋ 혹시 줄 바꿈을 여러 번 할 수 있게 가능한 방법을 알고 계신다면, 그것도 댓글로 알려주세요! 감사합니다🙏