Markdown 문법 사용법

zeew00·2024년 8월 13일
0
post-thumbnail

- 마크다운(Markdown) -

1. 마크다운이란 무엇일까

마크다운은 일반 텍스트 기반의 경량 마크업 언어입니다.

태그 등을 이용해서 문서나 데이터의 구조 등을 명기하는 언어의 한 가지이며 텍스트만으로 서식이 있는 문서들을 작성할 때 자주 사용되고 다른 마크업 언어들에 비해 문법이 쉽고 간단한 것이 특징인데 HTML 등의 서식 문서들로 쉽게 변환되기 때문에 README.md 파일이나 온라인 게시물 등에 자주 사용됩니다.

2. 마크다운 문법의 장단점

  • 문법이 쉽고 관리가 편리합니다.

  • 지원 가능한 플랫폼 및 프로그램이 다양합니다.

  • 정해진 표준이 없어 사용자마다 작성하는 문법의 유형이 다를 수 있습니다.

  • 단점으로는 모든 HTML 마크업을 대체할 수는 없습니다.

3. 사용처

- 마크다운 문법은 지원하는 모든 곳에서 사용이 가능합니다. - 워드 프레스 외 **'Slack'** 이나 **'Notion'** 등의 서비스에서 메세지를 작성하는 것 처럼 사용할 수도 있습니다. - 마트다운의 각 문법들은 HTML로 변환되어 CSS와 함께 출력되기 때문에 화면에 표시되는 모양은 사용하는 곳의 스타일 구서에 따라서 달라집니다. 따라서 눈에보이는 스타일이 아닌 각 문법의 의미에 맞게 사용해야 합니다.

4. 제목(title)

- 책에서 목차는 여러개가 있을 수 있지만 제목은 하나인 것처럼 하나의 마크다운 파일에서는 하나의 '대제목'만 사용해야 합니다.
  • # = <h1></h1>
  • ## = <h2></h2>
  • ### = <h3></h3>
  • #### = <h4></h4>
  • ##### = <h5></h5>
  • ###### = <h6></h6>

5. 강조(Emphasis)

  • 기울임 <em> = *별 기호(Asterisks)* 또는 _언더바 기호(underscore)_
  • 두껍게 <strong> = **Asterisks** 또는 __underscore__
  • 두 가지를 혼용 = __*기울임과 두껍게*__
  • 취소선 <del> = ~~물결 기호(tilde)~~
  • 밑줄 <u></u> = 마크다운에서 지원하지 않음으로 직접 태그를 입력

위와 같이 입력할 경우 아래와 같이 보여지게 됩니다.

6. 목록(List)

  • <ol>, <ul>, <li> 태그로 변환되는 목록을 표현합니다.

  • 1.으로 시작하는(순서가 있는) 항목을 작성 시 <ol>(Ordered List)로 변환되며
    -로 시작하는(순서가 없는) 항목을 작성 시 <ul>(Unordered List)로 변환되고
    둘중 하나를 입력 후 들여쓰기를 통해 하위 목록을 작성할 수 있습니다.

현재 탭에서 열리는 것이 기본이지만 새로운 탭에서 열릴 수도 있습니다.

  1. Link 문법의 사용 구조

    • 인라인 링크 :
      [google](https://google.com) 클릭 시 구글로 이동
    • 위에 예시처럼 입력 시 아래의 태그를 입력한 것과 동일하게 보입니다.
      <a href="https://google.com">google</a>

    • 제목 속성이 있는 링크 :
      [naver](https://naver.com "네이버 사이트로 이동")
      해당 링크에 마우스 커서를 위치할 시 링크 설명란 툴팁이 나타납니다.

  2. 실제 적용 예시 : google, naver

8. 사진(images)

링크와 비슷하지만 앞에 '!' 기호를 추가해야 합니다.

  1. 문법 사용 구조 :
    - ![텍스트명](이미지 주소)

  2. 실제 적용 예시와 출력 결과
    - ![Minions](https://velog.velcdn.com/images/zeew00/post/5a15e81b-d95b-4a82-9eca-0bfabb300a19/image.png)
    Minions

아래의 태그는 위와 같은 결과를 출력합니다.
<img src ="https://velog.velcdn.com/images/zeew00/post/bd8ea928-0d1d-4943-8708-395438dea4a3/image.png">

9. 코드 강조 (Code Emphasis)

  • <pre>, <code> 태그로 변환되는 코드를 표현하며 백틱(`) 기호를 사용합니다.

  • 마크다운에서 백틱(`) 기호는 코드의 강조를 표현할 때 사용하는 문법 기능을
    가지므로 백틱 기호 자체를 출력하려면 기호에 이스케이프 처리가 필요합니다.
    또는 `에서 인라인 코드를 강조하기 위해 <code> 태그를 활용할 수 도 있습니다.

9-1. Inline Style

  • 강조할 코드를 백틱(`) background 또는 background-image
    속성으로 요소에 배경 이미지를 삽입할 수 있습니다.

9-2. Block Style

  • 백틱(`)으 세 번 이상 입력하고 언어(코드) 이름을 명시하여 코드블록을 표현하고
    코드블록의 시작 백틱과 종료 백틱의 개수는 둘이 동일해야 합니다.

  • 문법 사용 구조

  • 실제 출력 결과

아래는 참고한 블로그 글의 링크입니다.

'Hreopy.dev'님의 블로그 글
'kimhyeongi.log'님의 블로그 글
profile
컴공 편입 폴붕이의 일상

0개의 댓글