MARKDOWN 문법

Markdown은

문서를 사람이 읽기 쉬운 간단한 문법으로 작성하면서도

다양한 형식으로 변환할 수 있게 해주는 문서 작성용 경량 mark-up 언어임.

 

이러한 특성 때문에

• Markdown은 정보를 구조화하여
• AI가 대화·작업의 전제를 이해하는데 사용하는
• 컨텍스트(context)를 명확하게 전달하는 context.md, gemini.md 같은 문서 형식으로 채택되고 있음
• 보다 기계친화적 context 전달은 JSON형태를 사용하기도 함.

https://dsaint31.me/mkdocs_site/CE/markdown_latex/markdown/

BME

 

참고: CommonMark 와 GFM

 

• CommonMark는 Markdown을 더 엄밀하게 표준화하려는 규격임
• GFM(GitHub Flavored Markdown)은 GitHub가 확장한 Markdown임

 

---

주의할 점

• 기본 문법: 거의 어디서나 됨
  • 제목, 목록, 링크, 굵게, 기울임, 인용문, 코드 블록
• 확장 문법: 환경 따라 다름
  • 표, 취소선, 체크박스, 각주, 수식, Mermaid, HTML 스타일링
• HTML/스타일 관련: 특히 자주 막힘

참고: mermaid

• Mermaid는 텍스트 문법으로 다이어그램을 그리게 해 주는 도구

 

 

---

Syntax (문법)

1. Title (제목)

#문자를 입력하고 제목을 입력.
# 1개 사용 시 가장 큰 폰트의 제목이 되고, 숫자가 늘수록 줄어듦.

• #는 <h1>태그에 해당함.
• ##는 <h2>태그에 해당함.

---

2. Horizontal line

---로서 -(hyphen)을 세 번 붙여서 입력하면 됨. <hr/>태그와 같음.

---

---

***

---

• 위에서 보이듯이 *를 세번 연달아 입력해도 같음.

---

3. Bold (굵은 글씨)

**로 굵은 글씨로 표시될 부분을 감싸면 됨. (_ 를 asterisk 대신 사용 가능: 즉 underscore 2개를 이용해도 됨)

이것은 **테스트**입니다.

이것은 테스트입니다.

---

4. Italic

* 로 이탤릭체로 표시될 부분을 감싸면 됨. (_ 도 가능)

이것은 *이탤릭체*입니다.

이것은 이탤릭체 입니다.

---

5. Cancel line (취소선)

~~ 로 취소선이 표시될 부분을 감싸면 됨.

이것은 ~~취소선~~ 테스트입니다.

이것은

취소선

테스트입니다.

Bold, Italic, Cancel line은 서로 중첩하여 사용가능함.

---

6. Under line

Markdown에선 기본적으로 underline을 지원하지 않아서 <u>태그를 사용하여 처리하는 게 일반적임
(단, html 태그 자체가 지원되지 않는 경우엔 사용불가).

이것은 <u>밑줄</u> 테스트입니다.

이것은 밑줄 테스트입니다.

---

7. New line

한 줄의 끝에 space를 두 번 입력하고 엔터 입력.

첫 줄입니다.[space][space][enter]
두번째 줄입니다.

첫 줄입니다.
두번째 줄입니다.

---

8. BlockQuote (인용문)

>문자를 입력하고 한 칸 띄운 뒤 인용문 내용을 작성함.
> 테스트

테스트

• 인용문 안에서 다른 markdown의 element도 사용가능함 (마크다운 에디터 따라 차이 있음).

---

9. Code (inline code)

내용 중에 코드를 삽입하는 경우.(코드 부분은 그대로 출력됨)

이것은 `print('test')` 처럼 inline code테스트임.

이것은 print('test') 처럼 inline code테스트임.

---

10. Code (block code)

특정 문단으로 코드를 삽입하는 경우에는 backtick을 세 개 연달아 사용.

```
import numpy as np

print(np.__version__)
```

import numpy as np

print(np.__version__)

• 시작하는 3개의 backtip 뒤에 python이나 c와 같이 코드 구문강조를 위한 코드 종류를 표기해도 됨.
• 2021.09.06 현재 Tistory의 마크다운에선 지원하지 않음.

---

11. List (목록)

숫자가 매겨진 list는 숫자와 period(.)를 입력하고 한 칸 띄어 해당 내용을 입력.

1. test0
2. test1

1. test0
2. test1

---

bullet list는 *를 입력하고 한 칸 띄어 해당 내용을 입력. (-,+ 도 가능)

* test0
* test1

• test0
• test1

---

아래와 같이 여러 레벨의 list도 가능

* test0
  * sub-item 0-0
  * sub-tiem 0-1
* test1
  * sub-item 1-1
  * sub-tiem 1-2

• test0
  • sub-item 0-0
  • sub-tiem 0-1
• test1
  • sub-item 1-1
  • sub-tiem 1-2

---

12. Link (or Hyper-link)

특정 URL에 대한 link는 다음과 같이 만듦.

[보여질내용](url)

실제 마크다운 문서에서는 보여질내용만 보이고, 해당 글을 클릭하면 지정된 url로 이동함.

 

[가천대홈페이지](gachon.ac.kr)

가천대홈페이지

---

[mailto: dsaint31](dsaint31@gachon.ac.kr)

mailto: dsaint31

---

[표시될 텍스트][id]
[id]: url "optional title"

[Google][1]
[1]: https://www.google.com "Go to Google"

• tistory등의 마크다운에선 동작하지 않음.

---

13. Image

본문 중에 이미지 삽입도 가능함.

![대체텍스트](이미지url)

---

![gaussian](https://search.pstatic.net/sunny/?src=https%3A%2F%2Fi.stack.imgur.com%2FRqai1.png&type=l340_165)

• 아직까지 image에 대한 삽입에서 정렬이나 크기 지정은 <img>태그를 이용하는게 보다 나음.

다음과 같이 확장된 markdown 이 지원되는 경우도 있음.

![대체text](img_URL){style="display: block; margin:0 auto; width:500px"}

---

14. Table

아래의 예를 보면 이해할 수 있음.

• Notion 에선 안됨. ==;;
• 기본 정렬은 왼쪽정렬임.

  | 기본정렬되는 열의 제목 | 가운데 정렬되는 열의 제목 | 오른정렬되는 열의 제목 |
  | --- | :---: | ---: |
  | hi | hello | 안녕 |
  | **hi** | **hello** | **안녕** |

  기본정렬되는 열의 제목	가운데 정렬되는 열의 제목	오른정렬되는 열의 제목
  hi	hello	안녕
  hi	hello	안녕

---

같이보면 좋은 자료들

https://ds31x.tistory.com/166

[vscode] Markdown+Math : vscode의 markdown에서 LaTeX수식 보기.

https://ds31x.tistory.com/174

[CE] Text file: Text 파일이란?

---