마크다운(MarkDown) 작성법

2021-04-13

Table Of Contents
  • This is an H1
  • H2 tag
  • 목록 또는 리스트(List)
  • 인용(BlockQuote)
  • 강조(Emphasis)
  • 수평선 (Horizontal Rule)
  • 줄바꿈(Line Breaks)
  • 체크 박스(Check Box)
  • 테이블(Table)
  • 링크(Link)
  • 이미지(Image)
  • 코드블록(Code Block)
  • 후기

  • 마크다운(MarkDown)이란?

    마크다운(MarkDown)은 산문을 읽고, 쓰고, 편집하기 쉬운 목적으로 만들어진 문서 작성을 위한 형식으로 사용되며, 문법이 간결하고 HTML삽입이 가능합니다.

    또한 마크다운을 작성한 문서의 표현 방식은 CSS의 설정에 따라 달라집니다.

    사람들이 자주 쓰는 Discord또한 일부 마크다운 문법을 지원합니다.


    마크다운 장점

    1. 문법이 간결하고 쉽다.
    2. 마크다운은 모든 것에 사용할 수 있습니다. (웹 사이트, 문서, 메모, 기술 문서 등)
    3. 마크다운은 지원하는 플랫폼이 많습니다. ( Github, Discord 등)
    4. 마크다운은 대부분의 환경에서 편집, 작성이 가능합니다. (메모장에서도 가능)
    5. 텍스트로 저장되기 때문에 용량이 적어 보관이 용이합니다.

    마크다운 단점

    1. 모든 HTML의 문법을 대신하지 못합니다.
    2. 표준이 없기 때문에 도구에 따라 변환방식 또는 생성물이 다릅니다.
    3. 마크다운으로 파일 업로드하는 경우 저장한 다음 파일 경로를 입력해야되는 불편함
    4. tistory, naver blog, notion과는 다르게 문법들을 하나하나 입력해야되는 경우가 있어 귀찮음이 조금 있습니다.

    마크다운(MarkDown) 문법(Syntax)


    헤더,제목,섹션(Header)

    글머리 1~6까지 크키 조절이 가능합니다.

    글머리가 많아질수록 글자의 크기가 달라집니다.

    마크다운은 Setextatx 두 가지 스타일의 헤더를 지원합니다.


    # Setext Style Header

    제목1(<h1>, =)과 제목2(<h2>, -)으로 표현할 수 있습니다.


    This is an H1
    =============
    
    This is an H1
    -------------
    

    This is an H1

    This is an H1


    # atx Style Header

    1부터 6까지 해시 기호(#)의 개수에 따라 글자 크기가 달라집니다.


    # H1 tag
    ## H2 tag
    ### H3 tag
    #### H4 tag
    ##### H5 tag
    ###### H6 tag
    

    H1 tag

    H2 tag

    H3 tag

    H4 tag

    H5 tag
    H6 tag

    목록 또는 리스트(List)

    순서 있는 목록, 순서 없는 목록 두 가지를 쉽게 작성할 수 있습니다.


    # 순서 없는 목록

    [+ * -] 3개의 글머리로 순서 없는 목록을 정렬할 수 있습니다.


    + 나는 1번째
      + 나는 1.1번째
        + 나는 1.2번째
    * 나는 2번째
    - 나는 3번째
    

    • 나는 1번째
      • 나는 1.1번째
        • 나는 1.2번째
    • 나는 2번째
    • 나는 3번째

    # 순서 있는 목록

    숫자. 형식으로 순서 있는 목록을 작성할 수 있습니다.


    1. 1번 리스트
        1. 1-1번 리스트
    2. 1번 리스트
    3. 1번 리스트
        1. 3-1번 리스트
        2. 3-2번 리스트
    4. 1번 리스트
    

    1. 1번 리스트
      1. 1-1번 리스트
    2. 1번 리스트
    3. 1번 리스트
      1. 3-1번 리스트
      2. 3-2번 리스트
    4. 1번 리스트

    인용(BlockQuote)

    > 꺽쇠 기호를 이용하여 작성할 수 있습니다.


    > 인용 1
    >> 인용 2
    >>> 인용 3
    
    > 인용 4
    
    >> 인용 5
    

    인용 1

    인용 2

    인용 3

    인용 4

    인용 5


    강조(Emphasis)

    굵게, 기울이기, 취소선 등의 텍스트를 강조를 할 수 있습니다.


    _기울여 쓰기_
    
    __굵게__
    
    *기울여 쓰기*
    
    **굵게**
    
    ~취소선~
    
    ~~취소선~~
    
    <u>밑줄은 마크다운에서 지원하지 않으므로 HTML를 사용하세요</u>
    
    _**중복 가능합니다.**_
    
    ~~__중복 가능합니다.__~~
    

    기울여 쓰기

    굵게

    기울여 쓰기

    굵게

    ~취소선~

    취소선

    밑줄은 마크다운에서 지원하지 않으므로 HTML을 사용하세요

    중복 가능합니다.

    중복 가능합니다.


    수평선 (Horizontal Rule)

    영역을 나누거나 줄을 표시할 때 [-, *, _]를 이용하여 수평선을 작성할 수 있습니다.

    ---
    
    영역 1
    
    ***
    
    영역 2
    
    ___
    
    끝
    


    영역 1


    영역 2



    줄바꿈(Line Breaks)

    새로운 라인으로 줄 바꿈 하기 위해서는 줄 바꿈 2번 또는 <br> 태그를 사용해야 합니다.

    알파벳의 구글 딥마인드에서 개발한 바둑 인공지능 프로그램. <!-- 엔터 한번 -->
    프로기사를 맞바둑으로 이긴 최초의 프로그램이기도 하다. <!-- 엔터 두번 -->
    
    이름에서 "Go"란 일본어로 바둑을 뜻하는 碁(바둑 기. 일본어 음독은 "고")[2][3]를 의미한다.<br>
    이는 일반적으로 서구 언론에서 바둑을 의미할 때 "고"란 말을 쓰기 때문이다.
    

    알파벳의 구글 딥마인드에서 개발한 바둑 인공지능 프로그램. 프로기사를 맞바둑으로 이긴 최초의 프로그램이기도 하다.

    이름에서 “Go”란 일본어로 바둑을 뜻하는 碁(바둑 기. 일본어 음독은 “고”)[2][3]를 의미한다.
    이는 일반적으로 서구 언론에서 바둑을 의미할 때 “고”란 말을 쓰기 때문이다.


    체크 박스(Check Box)

    [] 대괄호를 이용하여 체크 박스를 만들 수 있습니다.

    [x] 대괄호 안에 x를 넣으면 체크된 상태로 됩니다.

    - [ ] 공부하기
    - [x] 프로젝트 회의하기
    - [X] 코드 100줄 이상 작성하기
    - [o] 잘못된 예
    
    • 공부하기
    • 프로젝트 회의하기
    • 코드 100줄 이상 작성하기
    • [o] 잘못된 예

    테이블(Table)

    차트를 정렬할 때 [| , : , -] 3가지의 특수문자로 작성할 수 있습니다.


    | 먹고싶은 과일 | 먹고싶은 고기 | 먹고싶은 음료수 |
    |:- | :-: | -:|
    | 사과 | LA갈비 | 몬스터 |
    | 배 | 닭갈비 | 파워에이드 |
    | 망고 | 제육볶음 | 2% |
    
    | 재밌는 드라마 | 드라마 제작사 | 드라마 개봉일 | 드라마 방송사 |
    | - | - | - | - |
    | 괴물 | 셀트리온엔터테인먼트 | 2021년 | JTBC |
    | 라이브 | 지티스트 (GT:st), 김규태 | 2021년 | tvN |
    | 쌈 마이웨이 | (주)팬엔터테인먼트, 김희열  | 2021년 | KBS 2TV |
    

    먹고싶은 과일 먹고싶은 고기 먹고싶은 음료수
    사과 LA갈비 몬스터
    닭갈비 파워에이드
    망고 제육볶음 2%
    재밌는 드라마 드라마 제작사 드라마 개봉일 드라마 방송사
    괴물 셀트리온엔터테인먼트 2021년 JTBC
    라이브 지티스트 (GT:st), 김규태 2021년 tvN
    쌈 마이웨이 (주)팬엔터테인먼트, 김희열 2021년 KBS 2TV

    [title](link) 형식으로 앵커(anchor)를 만들 수 있습니다.


    [example](https://example.com)
    
    [naver](https://www.naver.com)
    
    [링크(Link)](#링크link)
    
    [``test``](https://example.com)
    
    + [test](https://example.com)
    

    example

    naver

    링크(Link)

    test


    이미지(Image)

    ![title](Image src) 형식으로 이미지를 나타낼 수 있습니다.


    ![자기야 왜 칭얼거려](https://i.imgur.com/XletaX7.jpgg)
    
    ![잉?](https://i.imgur.com/SiQDzMB.jpg)
    

    자기야 왜 칭얼거려

    잉?


    코드블록(Code Block)

    코드 블록을 나타내는 방법은 3가지의 방법이 있습니다.


    # 역따옴표


    ```
    역따옴표 Code Block
    ```
    
    ```python
    import requests
    
    rg = requests.get
    rp = requests.post
    
    _rg = rg("https://google.com").text
    _rp = rp("https://google.com").text
    ```
    
    ```js
    var add = (num1, num2) => {
        return num1 + num2;
    }
    console.log(add(1,2));
    ```
    

    역따옴표 Code Block
    
    import requests
    
    rg = requests.get
    rp = requests.post
    
    _rg = rg("https://google.com").text
    _rp = rp("https://google.com").text
    
    var add = (num1, num2) => {
        return num1 + num2;
    }
    console.log(add(1,2));
    

    # 물결표


    ~~~
    물결표 Code Block
    ~~~
    
    ~~~sql
    SELECT 1;
    SELECT * FROM Login WHERE id='admin';
    SELECT group_concat(table_name) FROM information_schema.tables WHERE table_schema=database();
    ~~~
    
    ~~~js
    var add = (num1, num2) => {
        return num1 + num2;
    }
    console.log(add(1,2));
    ~~~
    

    물결표 Code Block
    
    SELECT 1;
    SELECT * FROM Login WHERE id='admin';
    SELECT group_concat(table_name) FROM information_schema.tables WHERE table_schema=database();
    
    var add = (num1, num2) => {
        return num1 + num2;
    }
    console.log(add(1,2));
    

    # 탭(Tab)


        탭(Tab) Code Block
        Hello!
    

    탭(Tab) Code Block
    Hello!
    

    후기


    마크다운은 문법이 간결하고 원하는 대로 쉽게 만들 수 있어서 자주 애용하는데 이 블로그를 쓰면서 새로운 문법도 알게 되었습니다.

    잘못 적은 문법이 있다면 마음껏 댓글에 피드백 주세요!