마크다운(Markdown)

Markdown에 대한 문법, 대해서 설명한다.

개요

마크다운(Markdown)은 텍스트 기반의 마크업언어이다. README 파일이나 온라인 문서, 혹은 일반 텍스트 편집기로 문서 양식을 편집할 때 쓰인다. 마크다운을 이용해 작성된 문서는 쉽게 HTML 등 다른 문서형태로 변환이 가능하다.
2004년에 존 그루버에 의해 만들어졌으며, 사람들이 읽기 쉽고 쓰기 쉬운 플레인 텍스트 포맷을 사용하여 쓸 수 있으면서 구조적으로 유효한 XHTML(또는 HTML)로 선택적 변환이 가능하게 하는 것이 목표이다.

Markdown

이 로고는 Dustin Curtis에 의해 만들어진 마크다운 로고이다.

문법

제목 (HEADERS)


#을 하나 쓰면 HTML의 <h1> 태그를, #을 두개 쓰면 <h2>태그를 의미한다. 1 ~ 6개까지 쓸 수 있고, #이 늘어날때마다 글씨 크기가 작아진다.

# This is a H1
## This is a H2
### This is a H3
#### This is a H4
##### This is a H5
###### This is a H6

제목 (HEADERS)

인용 (BLOCK QUOTE)


인용된 글을 표시하고자 할 때, > 기호를 사용한다.

> This is a blockqute.

> This is a blockqute.

This is a blockqute.

This is a blockqute.

목록 (LISTS)


**순서가 없는 목록(Bullet Lists)**은 *, +, - 기호를 사용하여, 계층이 필요한 경우에는 들여쓰기를 하면 된다.

* one
  * two
    * three
  • one
    • two
      • three
+ one
  + two
    + three
  • one
    • two
      • three
- one
- two
- three
  • one
  • two
  • three

**순서있는 목록(Numbered Lists)**은 숫자를 사용합니다. 특징으로는 숫자의 순서와 상관없이 무조건 차례대로 표시된다.

1. one
2. two
3. tree
  1. one
  2. two
  3. tree
1. one
1. two
1. tree
  1. one
  2. two
  3. tree
2. one
1. two
3. tree
  1. one
  2. two
  3. tree

수평선 (HORIZONTAL RULES)


--, ***, ___ 기호 3개이상은 수평선으로 삽입된다.

***

강조(EMPPHASIS)


*single asterisks*

single asterisks

_single underscores_

single underscores

**double asterisks**

double asterisks

__double underscores__

double underscores

++underline++

++underline++

~~cancelline~~

cancelline


[구글](http://www.google.com)

구글

이미지 (IMAGES)


이미지 경로는 http:// 로 URL 경로 전체를 쓰셔도 되고, 같은 서버 경로에서 써도 된다.

![사진이름](사진경로)
![Alt text](/logo/64x64.png)
![Alt text](/logo/64x64.png "Optional title")

Alt text

코드 (CODE)


 `코드 내용`

코드 내용

코드 블록 (CODE BLOCKS)


코드 블록 표시는 ```로 시작해서 3개 ```으로 닫는다.

```java
 Sptring str = "this is Code Blocks"; 
` ``
 Spring str = "this is Code Blocks";

Markdown에 이미 사용되는 기호 표시(BACKSLASH ESCAPES)


Markdown 문법에 사용되는 기호를 있는 그대로 표시하고 싶을 경우가 있다. 예를 들어 # 마크를 그냥 쓰면 실제로는 H1 제목으로 출력되기 때문에 이 기호를 그대로 출력하고 싶다면 기호 앞에 \(=back slash) 문자를 써주면 된다. \\(=back slash)를 그대로 사용하고 싶은 경우에는 \\\\를 2개를 쓰면 됩니다.

Markdown에서 사용하는 기호는 아래 다음과 같다.

\   backslash
`   backtick
*   asterisk
_   underscore
{}  curly braces
[]  square brackets
()  parentheses
#   hash mark
+   plus sign
-   minus sign (hyphen)
.   dot
!   exclamation mark

확장 문법 및 기능

각주(footnote)

주(註) 또는 각주(영어: footnote 또는 annotation 등)는 아래와 같이 본문에 대하는 참조 문헌이나 본문의 낱말, 문장 등의 뜻을 알기 쉽게 풀이하는 덧붙이는 글이다.

기본 Markdown 문법에는 각주 기능이 없고, Markdown Extended Syntax의 Footnotes 기능이 있다.

다음은 간단한 각주입니다.[^foonote]

[^foonote]: 첫 번째 각주입니다.

기능 확장을 하지 않고 아래와 같이 html을 이용하는 방법도 있다.

다음은 간단한 각주입니다.<sup>[1](#footnote_1)</sup>

<!-- 글 마지막 부분에 -->
---

<a name="footnote_1">1</a>. 첫 번째 각주입니다.

참조




최종 수정 : 2024-01-18