Python/MarkDown

[Markdown] Jupyter Notebook :: 주피터 노트북 마크다운 정리

슈퍼짱짱 2021. 6. 15. 16:22
반응형

주피터 노트북에서 마크다운을 활용하는 여러가지 기능들을 소개하고자 한다.

 

마크다운이란?

먼저, 마크다운이란 일반 텍스트 문서의 양식을 편집하는 문법으로, HTML의 형태로 변환이 가능하다.

마크다운은 HTML과 아주 깊게 연관되어 있어, 웹 프로그래밍 중 HTML 문법을 알고 있다면 더욱 다양한 활용이 가능하다.

 


1. 마크다운 사용하기

주피터 노트북에서 마크다운을 사용하려면 먼저, Code Cell 에서 Markdown Cell 로 변경해 주어야 한다.

 

변경하는 방법은 다음과 같다.

1. esc + m

2. Cell -> Cell Type -> Markdown

 

첫 번째 방법은 단축키를 활용하는 방법으로, 마크다운 셀로 변경하고자 하는 셀을 클릭 후, esc로 커서를 없애주고, m을 눌러 마크다운 셀로 변환한다.

 

두 번째 방법은 단축키 없이 직접 변환하는 방법으로, 다음과 같이 Cell -> Cell Type -> Markdown 을 클릭하여 변환한다.

 

 

그럼 아래와 같이 코드셀에서 마크다운 셀로 변환된다.

 

Code Cell
Markdown Cell

 


2. Header

마크다운의 가장 기본인 Header(제목)을 지정하는 방법이다.

"#"을 활용하여 header(제목) 기능을 사용할 수 있고, "#"의 개수로 header의 크기를 조절할 수 있다.(1~6개까지 지원)

# 한 개가 가장 크고, 개수가 늘 수록 작아진다.

 

결과는 다음과 같다. 6개까지만 지원하므로, 마지막 7개는 header로 변환되지 않았다.

 

 

이를 "#"이 아닌, HTML 문법으로도 표현할 수 있다.

* HTML 문법은 <> 안에 어떤 기능을 쓸 지 들어가고, 마지막에는 꼭 </>로 짝을 맞춰줘야 한다.

 

 

결과는 다음과 같다.

 

 


3. Quote (인용)

많이 쓰는 기능은 아니지만, 인용문은 ">" 로 활용할 수 있다.

인용문 안에 들여쓰기로 두 번째, 세 번째 인용문을 쓸 수도 있고, 마크다운 문법도 그대로 사용할 수 있다.

 

 


4. List(목록, level)

목록은 순서가 있는 목록과 없는 목록으로 나눌 수 있으며, 들여쓰기도 가능하다.

 

먼저, 순서가 있는 목록은 그냥 숫자로 표현하면 된다.

 

 

순서가 없는 목록*, +, - 로 표현할 수 있고, 어떤걸 쓰던 상관없으며 섞어서 써도 된다.

결과는 모두 똑같이 ⦁ 으로 표시된다.

 

 

들여쓰기로 level을 표시할 수도 있는데, 순서가 있는 목록과 없는 목록을 함께 쓸 수도 있다.

들여쓰기로 표시하고 싶은 level은 띄어쓰기 혹은 tab 후 내용을 써주면 된다.

 


5. 수평선

내용이 바뀔 때 많이 활용하는 기능으로, Line 을 추가하는 방법이다. 

회색 선으로 표시된다.

 

방법을 다음과 같이 *** or --- or <hr>로 표현할 수 있다.

 


6. 줄바꿈

마크다운을 처음 사용하다보면 가장 당황스러운 부분이다. 분명히 enter를 쳤는데 줄바꿈이 안된다.

이럴 땐 space(띄어쓰기)를 2번 or <br>을 넣어주면 된다.

 

 

잘 보이지는 않지만, "첫 번째 줄" 뒤에 두 번의 띄어쓰기가 숨어있다.

 


7. Font

글자 색, 크기, 굵기, 기울기, 글꼴 바꾸는 방법이다.

모두 기본 문법은 다음과 같이 똑같다.

 

<span style="">쓰고 싶은 내용</span>

 


글자 색color로 표현한다.

 


글자 크기font-size로 표현한다.

px, %, em 등의 단위로 표현할 수 있다.

 

 

참고로 line-height는 줄 높이를 의미한다. 50px일 때는 글자크기가 커서 줄 높이를 따로 지정해 주지 않으면, 글자가 잘리기 때문에 추가해주었다.


굵게**와 font-weight:bold 로 표현할 수 있다.

 


기울임*와 font-style:italic 으로 표현할 수 있다.

 

 


글꼴은 font-family로 표현 할 수 있다.

(글쓴이는 mac을 쓰고있는데, 지원하는 한글 글꼴이 하나뿐이라 아래 예시에서 글꼴이 바뀌지 않았다.)

 


한 번에 적용해 볼 수 도 있다.

 

 

이를 모두 정리하면 각각이 의미하는 것은 다음과 같다.

 

색 상  color : 색상이름 또는 색상코드   
굵 기  font-weight : bold  
기울임  font-style : italic  
크 기  font-size : 숫자px, 숫자% 또는 숫자em  
글 꼴  font-family : 굴림, 돋움, 궁서, Arial, 등등   
줄높이  line-height : 숫자px, 숫자% 또는 숫자em  

 


8. Link

마크다운에 link를 거는 방법은 다음과 같다.

 

 

1번 처럼 그냥 주소를 넣은 경우, 알아서 링크가 걸린다. 단, 주소 그대로 표현된다.

2번은 지정해준 글자에 링크를 넣는 방법이다.

3번 역시 지정해 준 글자에 링크가 걸리나, [1], [2] 처럼 참조형태로 링크를 거는 방법이다.

 

기본적으로 [링크이름](주소) 의 형태로 링크를 걸어준다.

 


9. IMAGE

마크다운에 이미지를 삽입하는 방법은 다음과 같다.

 

기본 문법은 ![이미지 이름](이미지 주소) 이다.

이미지 이름은 만약, 이미지의 주소가 변한다거나 등의 이유로 문제가 생겼을 때 뜨는 이름이다.

이미지 주소는 웹상의 주소를 넣어도 되고, local에 저장되어있는 이미지라면, 그 path를 넣어도 된다.

 

 

이미지 크기를 조절하고 싶다면, 다음과 같이 하면된다.

 

<img src="이미지 주소widthheightalt = ></img>

 

widthheight에 원하는 사이즈를 넣어준다. 이미지 주소는 역시 local에 저장되어 있는 이미지의 path도 가능하다.

alt은 이미지에 문제가 생겼을 때 나타나는 이름이다.

 


10. Table

마크다운에 table을 직접 입력할 수도 있다.

| 로 뼈대를 잡아주고, 컬럼명과 내용은 -- 로 구분해준다.

굵게, 기울임 등 기본적인 마크다운 문법도 적용 가능하다.

 


11. Code

마크다운으로 코드도 이쁘게 넣어줄 수 있다.

python 뿐 아니라, java, C, C++ 등 왠만한건 다 가능하다.

 

```language

```

안에 코드를 넣어주면 된다.

 


12. Tex

마지막으로, tex 문법을 활용하여 수학식도 넣어줄 수 있다.

 

$ 의 형태로 입력하면 왼쪽 정렬된 결과가 나오고,

$$ 의 형태로 입력하면 가운데 정렬되고 자동으로 오른쪽에 숫자가 카운팅된다. 

수학식이 늘어나면 이 숫자도 자동으로 커진다.

 

$사이에 수학식은 Tex 문법으로 다양하게 활용 가능하다.

 

반응형

'Python > MarkDown' 카테고리의 다른 글

[Markdown] Jupyter notebook tab like r markdown(widgets)  (0) 2021.09.14