📘 [Markdown] 마크다운 문법 정리 - 2

2025년 02월 27일 in Study / ETC on #Markdown

[Markdown] 마크다운 문법 정리

---

• 📝 마크다운의 장단점
  • ✅ 장점
  • ✅ 단점
• 1. 코드블럭
  • 1.1. <pre><code>{code}</code></pre> 이용방식
  • 1.2. 코드블럭코드(``` 또는 ~~~) 을 이용하는 방법
  • 1.3. 들여쓰기
  • 1.4. 언어별 코드블럭
• 2. 기호표시
  • ✅ Markdown에서 이미 사용되는 기호, 표기하기
• 3. 접기 펼치기 기능
• 4. 수학수식
• 📑 Reference

📝 마크다운의 장단점

---

✅ 장점

1. 간결하다.
2. 별도의 도구없이 작성가능하다.
3. 다양한 형태로 변환이 가능하다.
4. 텍스트(Text)로 저장되기 때문에 용량이 적어 보관이 용이하다.
5. 텍스트파일이기 때문에 버전관리시스템을 이용하여 변경이력을 관리할 수 있다.
6. 지원하는 프로그램과 플랫폼이 다양하다.

✅ 단점

1. 표준이 없다.
2. 표준이 없기 때문에 도구에 따라서 변환방식이나 생성물이 다르다.
3. 모든 HTML 마크업을 대신하지 못한다.

---

1. 코드블럭

---

위에서 장단점을 설명할때와 같이 회색 박스

4가지 방식을 사용할 수 있다.

(1. <pre><code> {code} </code></pre>)

(2. ``` 또는 ~~~ )

(3. 들여쓰기)

(4. 언어별 코드블럭)

---

1.1. <pre><code>{code}</code></pre> 이용방식

---

<pre>
<code>
def func(a,b):
    return a+b
print(func(2,3))
</code>
</pre>

🔍 결과

def func(a,b):
    return a+b

print(func(2,3))

---

1.2. 코드블럭코드(``` 또는 ~~~) 을 이용하는 방법

---

```
def func(a,b):
    return a+b

print(func(2,3))
```

🔍 결과

def func(a,b):
    return a+b

print(func(2,3))

---

1.3. 들여쓰기

---

탭이나 스페이스 4번을 통해 코드블럭을 만들수 있다.

    def func(a,b):
        return a+b

    print(func(2,3))

🔍 결과

def func(a,b):
    return a+b

print(func(2,3))

---

1.4. 언어별 코드블럭

---

python

~~~python
  def func(a,b):
      return a+b

  print(func(2,3))
~~~

🔍 결과

   def func(a,b):
       return a+b

   print(func(2,3))

css

~~~css
.tipue_search_icon
{
	 width: 19px;
	 height: 19px;
	 margin-bottom: 0rem;
	 background-color: #626591;
}
.tipue_search_left
{
	 float: left;
	 padding: 10px 5px 0 0;
	 color: #e3e3e3;
	 max-height: 20px;
}
~~~

🔍 결과

.tipue_search_icon
{
	width: 19px;
	height: 19px;
	margin-bottom: 0rem;
	background-color: #626591;
	}
.tipue_search_left
{
	 float: left;
	 padding: 10px 5px 0 0;
	 color: #e3e3e3;
	 max-height: 20px;
}

• 그밖에

  • Bash (bash)
  • C# (cs)
  • CSS (css)
  • Diff (diff)
  • HTML, XML (html)
  • Ini (ini)
  • JSON (json)
  • Java (java)
  • JavaScript (javascript)
  • PHP (php)
  • Perl (perl)
  • Python (python)
  • Ruby (ruby)
  • SQL (sql)

---

2. 기호표시

---

✅ Markdown에서 이미 사용되는 기호, 표기하기

Markdown 문법에 사용되는 기호를 있는 그대로 표시하고 싶을 경우가 있다. 예를 들어 # 마크를 그냥 쓰면 H1 제목으로 출력된다. 또 t.max(dim=0)\[0]를 있는 그대로 쓰면 t.max(dim=0)[0]게 된다.

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

위 기호들을 있는 그대로 쓰고 싶다면 기호 앞에 \(=back slash) 문자를 써주면 된다. \(back slash)를 그대로 쓰고 싶다면 \\를 2개 쓰면 된다.

---

3. 접기 펼치기 기능

---

마크다운에서 접기/펼치기 가능한 컨트롤 문법
마크다운 자체에는 기능이 없고 html을 이용

html의 details 사용

<details>
<summary>접기/펼치기</summary>
<div markdown="1">

| 제목 | 내용 |
| ---- | ---- |
| a    | b    |
| c    | d    |

</div>
</details>

🔍 결과

접기/펼치기

제목	내용
a	b
c	d

---

4. 수학수식

---

Lorem ipsum \(f(x) = x^2\).

$f(x) = x^2$

---

📑 Reference

---

• ihoneymon 님의 마크다운

---