[기술]마크다운 사용하기

1. 마크다운이란?

마크업 언어는 문서가 화면에 표시되는 형식을 나타내거나 데이터의 논리적인 구조를 명시하기 위한 규칙들을 정의한 언어의 일종이다. 가장 대표적인 마크업 언어로는 HTML이 있으며 컴퓨터 환경에서 표준으로 자리잡은 상태이다.

그러나 HTML은 태그와 문장으로 구성되어있어 일상적인 문서작성에는 불편한 점이 많은 언어였고 또 제대로 쓰기 위해선 CSS언어도 함께 기술해 주어야 한다.

마크다운은 이러한 HTML의 단점을 개선하기 위해 만들어진 마크업 언어로써, HTML에 비해 보다 기술자나 관련 학술자들이 좀더 편하게 문서를 작성할 수 있게 해준다. 또한 대부분의 마크다운 사용처에서는 md 파일을 HTMl로 컴파일(변환)해주는 작업을 거치기 때문에 마크다운 문서를 작성하면서 HTML언어와 CSS언어도 함께 사용해줄 수 있다.

마크다운의 장점

• 쓰기 편하고 배우기 쉬움
• 비교적 최신 언어라 팬시한 이용처가 많음(R Studio, Jupyter Notebook, Git-Hub)
• HTML과 CSS를 배운 상태라면 필요한 부분에만 커스텀을 해줄 수 있음

마크다운의 단점

• HTML과 CSS를 모른다면 적용할 수 있는 스타일에 한계가 있음
• 편집기마다 문법이 조금씩 다름

---

2. 마크다운 매뉴얼

일반적으로 마크다운과 같은 언어는 외울 필요 없이 치트시트를 보면서 필요한 것만 쓰는게 최선이다. 따라서 여기에 기술된 것들을 필요에 따라 참고해가면서 사용하면 될 것이다.

A. 문서 구성하기

ㄱ. 문장 줄 바꾸기

문장과 문장의 줄 바꿈은 spacebar를 두번 쳐줌으로써 기능할 수 있다.

ㄴ.문단 바꾸기

문단을 바꾸기 위해서는 Enter를 두번 쳐주면 된다.

이 편집기(Typora)는 부가 기능으로 엔터만 쳐도 줄바꿈 기능을 제공하지만 대부분의 편집기는 이러한 기능을 제공하지 않는다.

ㄷ. 제목 달아주기

문서를 작성할 때 제목과 소제목을 달아주기 위해서는 #을 문장 앞에 달아주면 된다.

샵2개

샵3개

샵4개

몇가지 편집기에는 이 #을 기준으로 링크를 달아주는 기능이 있으므로 잘 사용해줘야 할 기능이다.

ㄹ. 목록 작성

목록을 작성하기 위해서는 숫자와 점, 혹은 - (대쉬)를 사용해주면 된다.

1. 목록1
2. 목록2
   • 항목(대쉬)1
   • 항목(대쉬)2

ㅁ.특수 기호 사용

마크다운에서 특수한 기능을 가지는 특수문자들(#,-,$ ,… 등)을 글에 그대로 사용해주고 싶다면 앞에 \ (백슬래쉬)를 쳐주면 된다. 위의 서술들에서 특수문자를 그대로 표기할 수 있었던건 이 기능을 사용해 주었기 때문이다.

ㅂ.문장스타일 지정하기

* 이탤릭* -> 이탤릭

** 볼드 ** -> 볼드

~~취소선~~ -> 취소선

---

B. 기타기능 삽입하기

ㄱ.링크

링크를 달아주기 위해서는 아래와 같은 양식으로 쳐주면 된다.

[링크 캡션](링크 경로)

[HGmin 블로그 주소](https://hgmin1159.github.io/)

HGmin 블로그 주소

ㄴ.이미지

이미지를 달아주기 위해서는 아래와 같은 양식으로 쳐주면 된다.



ㄷ.수식

Latex 이라는 또다른 마크업 언어의 수식구조 체계를 사용하며 수식뿐 만아니라 다른 Latex문법도 그대로 사용해줄 수 있다.
안타깝게도 깃헙마크다운은 latex 수식을 지원하지 않는 것 같다. 그래도 주피터나 R studio에서는 아래와 같이 수식을 사용할 수 있다.

수식을 삽입하기 위해서는 $ 문구를 이용하면 된다.

$Latex 수식 문구$

$ \frac{1}{\sqrt{2\pi}\sigma}exp(-\frac{(x-\mu)^2}{2\sigma^2}) $ (정규분포의 확률밀도함수)

수식에 대한 강조삽입을 위해서는 $를 두번 사용해준다. 위의 경우는 줄글에 수식을 넣을 수 있지만 이 경우 줄글과 수식은 줄바꿈이 적용된다.

$$1+1=3$$

ㄹ.코드 박스

코드 박스를 삽입하기 위해서는 `를 이용한다.

\print("helloworld")\

print("helloworld")

좀더 큰 박스를 이용하기 위해서는 아래와 같이 쳐준다.

```for n in range(10) : print(str(n)+”: “+”명의 아해가 길을 간다 하오”)```

for n in range(1,11) : 
	print(str(n)+"명의 아해가 길을 간다 하오")

ㅁ.박스인용문구

>이 안에 적으면 뭘 적든 명언 같아 보인다. - H.G Min

이 안에 적으면 뭘 적든 명언 같아 보인다. - H.G Min

ㅂ.구분선

***

---