설치하기
M-x를 누른 후, list-package를 입력한다.
markdown-mode를 찾아서 설치한다.
사용법
Markdown 모드로 전환 : M-x를 누른 후, markdown-mode를 입력한다.
GitHub 스타일의 markdown 모드(GitHub Flavored Markdown, GFM)로 전환 : M-x를 누른 후, gfm-mode를 입력한다.
Markdown 요소 입력 단축키
Markdown / GFM 모드에서 아래의 단축키들을 사용하여 Markdown 요소들을 한번에 추가/수정하는 것이 가능하다.
- C-c C-t 1 : 1단계 제목 요소 입력
- C-c C-t 2 : 2단계 제목 요소 입력
- C-c C-s e : 이탤릭체 요소 입력
- C-c C-s s : 볼드체 요소 입력
- C-c C-s b : 인용 블럭 변환
- C-c C-s c : 코드 블럭 변환
- C-c C-a l : 인라인 링크 입력
- C-c C-j : 리스트 아이템 입력
- C-c - : 가로줄 입력
- C-c C-k : 입력한 요소를 한번에 삭제
보다 많은 단축키에 대해서는 참고 사이트나 emacs 상의 Markdown 메뉴를 참고하도록 한다.
HTML 변환 관련 단축키
Markdown –> HTML 변환 기능을 지원하기 위해 다음 단축키들을 제공한다.
- C-c C-c m : 변환한 결과를 다른 버퍼창을 통해 보여준다.
- C-c C-c e : 변환한 결과를 HTML 파일로 저장한다.
- C-c C-c p : 변환한 결과를 브라우저를 통해 보여준다.
[참고] 많은 경우, 생성된 HTML에 charset 설정이 되어있지 않기 때문에 한글 사용시 제대로 보이지 않을 수 있다. <head>~</head> 사이에 아래와 같은 형태로 인코딩 지정을 추가하면 한글을 제대로 볼 수 있다.
<head>
...
<meta charset="utf-8">
</head>
외부 변환 프로그램 세팅
HTML 변환 기능을 사용하기 위해서는 외부 변환 프로그램 세팅이 필요하다. 변환 프로그램은 플랫폼의 종류에 따라 여러가지가 있지만 여기서는 윈도우 환경 등에서 사용할 수 있는 MultiMarkdown 프로그램을 사용하겠다.
- http://fletcherpenney.net/multimarkdown/을 방문하여 다운로드 페이지에서 프로그램을 다운받아 설치한다. (스페이스가 포함되지 않은 경로에 설치하여야 한다.)
- .emacs 파일에 다음과 같이 MultiMarkdown 실행파일의 경로를 추가한다.
(setq markdown-command "C:/MultiMarkdown/bin/multimarkdown.exe")
Markdown Preview Mode 설치
수동으로 Markdown을 HTML으로 변환한 결과를 확인하려면 번거로운 점도 있고, 위에서 언급한 한글 인코딩 문제도 있기 때문에 markdown preview mode도 같이 설치할 것을 추천한다. 패키지 리스트에서 markdown-preview-mode를 검색해서 설치한다.
설치 후, Markdown 모드에서 M-x markdown-preview-mode를 입력하면 브라우저 창이 뜨고, 저장시 실시간으로 변환 결과를 확인할 수 있다. 물론 한글 문제도 없다.
Preview mode를 종료하려면, M-x markdown-preview-cleanup을 입력하면 사용된 웹서버가 종료된다.
참고 사이트
<테스트 환경>
OS : Windows 7
Emacs 버전 : Emacs 24.3 윈도우
