Markdown 문법에 대한 가이드라인

funfungun·2025년 2월 1일
post-thumbnail

마크다운은 특수기호와 문자를 이용한 매우 간단한 구조의 문법을 사용하여 웹에서도 보다 빠르게 컨텐츠를 작성하고 직관적으로 인식할 수 있습니다. 오늘은 마크다운 문법에 대해 자세히 알아보겠습니다.


  1. 제목
    h1부터 h6까지 표현할 수 있으며, #의 갯수 로 표현이 가능합니다. 혹은 =,- 를 각각 2개 이상 사용해도 h1h2#을 대체할 수 있습니다.

    Markdown 작성 시
    
    # h1
    ## h2
    ### h3
    #### h4
    ##### h5
    ###### h6

    Markdown 작성 시
    
    h1
    ==
    h2
    --
    
    하이픈을 여러 개 사용한 제목
    ----------


  1. 문단 간격
    문단의 간격은 줄 바꿈으로 나타내며, 여러 번 줄 바꿈 시<br/> 을 사용하면 됩니다.
    Markdown 작성 시
    
    첫 번째 문단<br/><br/>
    두 번째 문단

  1. 목록
    순서를 표기하는 목록과 순서가 없는 목록 두 가지를 작성할 수 있습니다.
  • 순서를 표기하는 목록
    숫자와 . 을 사용하여 작성해야 합니다.

    Markdown 작성 시
    
    1. 첫 번째
    2. 두 번째
    3. 세 번째

  • 순서가 없는 목록
    -, *, + 을 사용하여 작성합니다. 인라인 코드, 블럭 코드를 작성할 수 있으며 Tab 키스페이스 바 를 사용하여 들여쓰기가 가능합니다.

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


  1. 폰트 스타일
    굵게, 기울이기, 취소선 등을 아래와 같이 작성할 수 있습니다.
    _굵게__
    **굵게**
    _기울여 쓰기_
    *기울여 쓰기*
    ~취소선~
    ~~취소선~~
    굵게__
    굵게
    기울여 쓰기_
    기울여 쓰기
    ~취소선~
    취소선

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

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


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

  1. 여러 줄로 된 코드 블럭
    백틱(`)을 세 개 사용하여 작성할 수 있습니다. 특정 언어로 된 코드 작성시, 백틱 3개 뒤에 언어 이름을 넣어주면 됩니다.
     Markdown 작성 시
    
      ``` 
      위 아래 3개로 감싸면 블럭으로 만들 수 있습니다.
      ``` 

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

    인라인 링크는 아래처럼
    [인라인 링크](https://www.naver.com/)
    
    url 링크는 아래처럼
    <https://www.naver.com//>


  1. 수평선
    * 이나 -, _ 등을 3개 이상 입력하면 작성할 수 있습니다.
    띄어쓰기를 중간에 삽입해도 되지만, 하이픈(-) 은 헤더로 인식할 수 있으니 주의해서 써야 합니다.
    ***
    -----
    __ __ __ __ __ __ __

  1. 이미지 링크
    이미지 링크는 아래와 같이 작성하면 됩니다.
    ![이미지 설명](이미지 링크)
    ![고양이](https://cdn.pixabay.com/photo/2019/03/13/08/29/cat-4052454_1280.jpg)

  1. 테이블
    | 로 구분하며, -(하이픈) 으로 구분된 곳 각각 왼쪽, 양쪽, 오른쪽에 :(세미콜론) 을 붙일 경우 순서대로 왼쪽 정렬, 가운데 정렬, 오른쪽 정렬이 가능합니다.
    | 드라마 제목 | 주연 배우 | 방영일 |
    |:----------|:----------:|----------:|
    | **호텔 델루나** | 이지은, 여진구 | ~~2019.07.13. ~ 2019.09.01.~~ |
    | 타인은 지옥이다 | 임시완, 이동욱, 이현욱, 이정은 | 2019.08.31. ~ |
    | 멜로가 체질 | 천우희, 안재홍, 전여빈, 공명 | 2019.08.09. ~ |

  1. 체크박스
    -, *, + 뒤에 띄어쓰기 후 대괄호 를 넣어 작성해줍니다. 대괄호 안을 공백으로 두면 빈 체크박스, x 를 넣으면 체크된 박스가 됩니다.

    Markdown 작성 시
    
    - [ ] 운동 하기
    - [x] 강의 듣기


  1. 글자 색상
    html 태그 를 이용해 작성 가능합니다.
    <span style="color:red">red</span>
    <span style="color:#d3d3d3">#d3d3d3</span>
    <span style="color:rgb(245, 235, 13)">rgb(245, 235, 13)</span>
    red
    #d3d3d3
    rgb(245, 235, 13)

이상으로 마크다운 문법에 대해서 간략하게 알아보는 시간을 가졌습니다. 다음 시간에는 git commit convention 가이드라인에 대해 알아보도록 하겠습니다.

profile
Commercial Art

0개의 댓글