sloth-code

[MD] 마크다운 markdown 작성 방법 본문

Resources/기초

[MD] 마크다운 markdown 작성 방법

Owl_Num 2025. 8. 15. 10:32


 

1. 제목 (Headings)

  • 용도: 문서의 구조를 정의하고 섹션을 구분하는 데 사용합니다. HTML의 <h1>부터 <h6> 태그에 해당합니다.
  • 작성법: 줄의 맨 앞에 # 기호를 사용하여 제목 수준을 지정합니다. #의 개수가 많아질수록 하위 제목이 됩니다. 최대 6단계까지 지원됩니다.
  • # H1 제목 ## H2 제목 ### H3 제목 #### H4 제목 ##### H5 제목 ###### H6 제목

2. 단락 및 줄 바꿈 (Paragraphs & Line Breaks)

  • 용도: 텍스트 단락을 구분하고, 단락 내에서 강제 줄 바꿈을 적용합니다.
  • 작성법:
    • 단락: 한 줄 이상 비우면 새로운 단락으로 인식됩니다.
    • 줄 바꿈: 줄 끝에 스페이스 두 번()을 입력한 뒤 엔터(Enter)를 누르거나, 한 줄 비우지 않고 단순히 엔터만 누르면 됩니다.
    이것은 첫 번째 단락입니다.
    이것은 같은 단락에서  (스페이스 두 번)
    줄 바꿈을 한 것입니다.
    
    이것은 두 번째 단락입니다. (한 줄 비움)

3. 강조 (Emphasis)

  • 용도: 텍스트를 기울임꼴(이탤릭체)이나 볼드체로 강조합니다.
  • 작성법:
    • 기울임꼴: 텍스트 양쪽에 * 또는 _ 하나를 붙입니다.
    • 볼드체: 텍스트 양쪽에 ** 또는 __ 두 개를 붙입니다.
    • 볼드체 및 기울임꼴: *** 또는 ___ 세 개를 붙입니다.
    *기울임꼴* 또는 _기울임꼴_
    **볼드체** 또는 __볼드체__
    ***볼드체이면서 기울임꼴*** 또는 ___볼드체이면서 기울임꼴___

4. 블록 인용 (Blockquotes)

  • 용도: 다른 소스에서 가져온 인용문을 시각적으로 구분하여 표시합니다.
  • 작성법: 인용하려는 문장 앞에 > 기호를 붙입니다. 여러 단락을 인용하거나, 중첩 인용도 가능합니다.
  • > 이것은 블록 인용입니다. > > > 이것은 중첩된 블록 인용입니다.

5. 목록 (Lists)

  • 용도: 항목을 나열할 때 사용하며, 순서 유무에 따라 두 가지 종류가 있습니다.
  • 작성법:
    • 순서 없는 목록 (Unordered List): 각 항목 앞에 -, *, + 중 하나를 붙입니다. 들여쓰기로 중첩 목록을 만들 수 있습니다.
    • 순서 있는 목록 (Ordered List): 각 항목 앞에 1.과 같이 숫자를 붙입니다. 숫자는 실제 순서에 영향을 주지 않으므로 1.만 반복해도 자동 번호가 매겨집니다.
    - 항목 1
    - 항목 2
      - 중첩 항목 2-1
    * 다른 기호로도 가능
      + 또 다른 기호
    
    1. 첫 번째 항목
    1. 두 번째 항목 (자동으로 2.로 표시)
    3. 세 번째 항목 (자동으로 3.으로 표시)

6. 코드 (Code)

  • 용도: 소스 코드나 명령어를 표시하여 일반 텍스트와 구분합니다.
  • 작성법:
    • 인라인 코드: 짧은 코드 조각을 문장 내에 삽입할 때 사용하며, 텍스트 양쪽에 ` (백틱) 하나를 붙입니다.
    • 코드 블록 (Fenced Code Block): 여러 줄의 코드를 블록으로 표시할 때 사용하며, 백틱 세 개(```)로 시작하고 끝냅니다. 첫 백틱 뒤에 언어 이름을 붙이면 신택스 하이라이팅이 적용됩니다.
    • 코드 블록 (Indented Code Block): 각 줄 앞에 탭(Tab) 한 번 또는 스페이스 네 칸()을 입력하여 코드 블록을 만듭니다.
    `print('Hello, World!')`와 같이 인라인 코드를 쓸 수 있습니다.
    
    ```python
    def hello_world():
        print("Hello, Markdown!")
    이것은 들여쓰기된 코드 블록입니다.
    두 번째 줄입니다.

7. 수평선 (Horizontal Rules)

  • 용도: 내용의 흐름을 시각적으로 구분하는 수평선을 삽입합니다.
  • 작성법: -, *, _ 중 하나를 세 개 이상 연속해서 입력합니다. 사이에 공백을 포함해도 무방합니다.
  • --- *** ___

8. 링크 (Links)

  • 용도: 다른 웹 페이지나 문서로 이동할 수 있는 하이퍼링크를 생성합니다.
  • 작성법:
    • 인라인 링크: [링크 텍스트](링크 주소 "선택적 제목") 형식으로 작성합니다.
    • 참조 링크: [링크 텍스트][참조 ID]와 같이 참조 ID를 사용하고, 문서의 다른 곳에 [참조 ID]: 링크 주소 "선택적 제목" 형식으로 주소를 정의합니다.
    [네이버](https://www.naver.com "네이버 메인 페이지")
    [구글][google]
    
    [google]: https://www.google.com "구글 검색 엔진"

9. 이미지 (Images)

  • 용도: 문서 내에 이미지를 삽입합니다.
  • 작성법: ![대체 텍스트](이미지 주소 "선택적 제목") 형식으로 작성하며, 링크와 유사하지만 맨 앞에 !가 붙습니다.
    • 대체 텍스트: 이미지를 표시할 수 없을 때 나타나는 텍스트.
    • 이미지 주소: 이미지 파일의 경로 (로컬 또는 웹 주소).
    ![고양이 이미지](https://example.com/cat.jpg "귀여운 고양이")

10. 표 (Tables)

  • 용도: 행과 열로 이루어진 데이터를 정돈하여 표시합니다.
  • 작성법: | (파이프)와 - (하이픈)를 사용하여 셀과 구분선을 만듭니다. 두 번째 줄은 헤더와 내용을 구분하는 구분선이며, 콜론(:)을 사용하여 정렬 방식을 지정할 수 있습니다.
  • | 헤더 1 | 헤더 2 | 헤더 3 | | :----- | :----: | -----: | | 왼쪽 정렬 | 중앙 정렬 | 오른쪽 정렬 | | 데이터 1 | 데이터 2 | 데이터 3 |

11. 체크박스 (Task Lists)

  • 용도: 할 일 목록이나 체크리스트를 표시하는 데 사용합니다.
  • 작성법: - [ ] 또는 - [x] 형식으로 각 항목을 만듭니다.
  • - [ ] 할 일 목록 1 - [x] 완료된 할 일 2 - [ ] 할 일 목록 3

12. 취소선 (Strikethrough)

  • 용도: 텍스트 위에 줄을 그어 취소되거나 삭제되었음을 표시합니다.
  • 작성법: 텍스트 양쪽에 ~~ (틸드) 두 개를 붙입니다.
  • ~~이것은 취소선입니다.~~

13. 이모지 (Emoji)

  • 용도: 텍스트에 이모티콘을 삽입하여 감성적인 표현이나 시각적 요소를 추가합니다.
  • 작성법: 대부분의 마크다운 파서에서 :이모지 코드: 형식으로 지원합니다 (예: :smile: → 😄). 지원 여부는 사용되는 플랫폼에 따라 다릅니다.
  • 안녕하세요! :wave: 오늘 날씨가 좋네요 :sunny:

14. 하이라이트 (Highlight)

  • 용도: 특정 텍스트를 강조하여 눈에 띄게 만듭니다.
  • 작성법: 텍스트 양쪽에 == (등호) 두 개를 붙입니다. 이 기능은 모든 마크다운 파서에서 표준으로 지원되지 않을 수 있으며, 일부 편집기나 플랫폼에서만 동작할 수 있습니다.
  • 이것은 ==하이라이트된 텍스트==입니다.

15. 수학 수식 (MathJax)

  • 용도: LaTeX 문법을 사용하여 복잡한 수학 수식을 표시합니다.
  • 작성법:
    • 인라인 수식: 텍스트 사이에 $수식$ 형식으로 작성합니다.
    • 블록 수식: 별도의 줄에 $$수식$$ 형식으로 작성하여 중앙 정렬된 수식 블록을 만듭니다. 이 기능은 MathJax 라이브러리를 지원하는 플랫폼에서만 동작합니다.
    피타고라스 정리 공식은 `$a^2 + b^2 = c^2$` 입니다.
    
    다음은 뉴턴의 운동 방정식입니다:
    $$ F = ma $$

 

Comments