[마크다운] Jupyter notebook을 Markdown으로 변환하는 방법

자연어처리(NLP) 공부를 하면서 정리해놓은 .ipynb파일이 꽤나 많아졌다. 이러한 내용들을 블로그에 업로드하려면 결국 .md로 바꿔줘야 한다.

그렇다면 어떠한 방법을 사용해야할까?

nbconvert

nbconvert는 jupyter notebook을 markdown 파일 혹은 html파일로 변환해주는 프로그램이다.

아래의 명령어를 통해 설치할 수 있다.

# pip을 통해 nbconvert 설치
pip install nbconvert

# conda를 통해 nbconvert 설치
conda install nbconvert

예를 들어 살펴보자.

Hello.ipynb라는 jupyter notebook 파일을 markdown 파일로 변환하고 싶다면? 이를 위해 먼저 Hello.ipynb 파일이 있는 경로로 이동한다. 그 뒤, 아래의 명령어를 실행한다.

jupyter nbconvert --to markdown Hello.ipynb

위의 명령어는 해당 경로에 다음의 두 가지 결과물을 생성한다.

• Hello.md : markdown 파일
• Hello_files : markdown 파일에 포함되어 있는 모든 이미지들을 모아놓은 폴더

이를 활용하여 Github 블로그에 포스팅 하기 위해서는 다음과 같은 작업을 거쳐야 한다.

1. Hello.md 파일 내 상단에 YAML 부분을 추가한다.
2. Hello.md 파일 내 이미지들의 경로를 블로그의 이미지 경로 형태로 수정한다.
3. Hello.md 파일의 파일명을 날짜(date)와 제목(title)을 포함하는 YYYY-MM-DD-TITLE.md 형태로 바꿔준다.
4. 이 YYYY-MM-DD-TITLE.md 파일을 블로그의 _posts 폴더로 이동시킨다.
5. Hello_files 폴더를 블로그의 images 폴더로 이동시킨다.

이제 이 파일들을 모두 add/commit/push하면 Github 블로그에 포스팅이 추가되는 것을 확인할 수 있다.