ViEditor/마크다운프리뷰

마지막으로 [b]

내용출력

로그인[l]

4 번째 수정본

윈도우 vim 에서 markdown 파일 실시간 미리보기

1. 개요

2. 맥과 리눅스의 경우

3. 필요한 것들 설치

4. 수정

4.1. instant-markdown-d 패키지

: 4.1.1. wrapper 스크립트
: 4.1.2. instant-markdown-d

5. 기타&comments

1. 개요

vim 플러그인 중에 vim-instant-markdown(Github: [1])이란 게 있는데, 이걸 설치하고 vim으로 마크다운 형식의 파일(*.md, *.markdown)을 열면 웹브라우저 창이 열리면서 현재 편집 중인 마크다운 파일을 렌더링한 결과물을 실시간으로 보여준다.

문제는 이게 맥과 리눅스에서만 동작하고 윈도우에서는 안 된다는 건데... 윈도우에서 "미리보기가 지원되며 실시간으로 반영되며, 코드 블록과 테이블 문법도 잘 지원되면서 이왕이면 신택스 하일라이트도 되고 무료인" 마크다운 편집기를 찾다 찾다 못 찾아서1... 이 플러그인을 윈도우에서 쓸 수 없을까 하며 토요일 하루밤을 삽질로 보내었다.

문제는 이 플러그인을 쓰는 과정이

node.js
vim script
윈도우의 명령 프롬프트 프로그래밍(맥이나 리눅스였다면 셸 프로그래밍)

세 가지의 조합이라서, 딱 원하는 형태로 만들기가 너무 힘들다는 것.

결국 그럭저럭 쓸 수 있는 상태로 만들었고, 이 페이지에 그 과정을 정리한다. 뭔가 불만족스러운 부분이 많이 남아 있어서, 혹시 누군가 이 글을 보고 도움을 주지 않을까 하는 기대도 있다.

2. 맥과 리눅스의 경우

그냥 플러그인 홈페이지([1])에 가서 시키는 대로 하면 된다.

You first need to have node.js with npm installed.

[sudo] npm -g install instant-markdown-d
If you're on Linux, the xdg-utils package needs to be installed (is installed by default on Ubuntu).
Copy the after/ftplugin/markdown/instant-markdown.vim file from this repo into your ~/.vim/after/ftplugin/markdown/ (creating directories as necessary), or follow your vim package manager's instructions.
Ensure you have the line filetype plugin on in your .vimrc
Open a markdown file in vim and enjoy!

3. 필요한 것들 설치

일단 윈도우에 필요한 것들을 설치한다.

node.js

https://nodejs.org/ko/ 여기에서 받아서 설치. 나는 5.6.0을 설치하였다. 설치하면 패키지 매니저인 npm도 덩달아 설치되고, PATH 환경 변수 설정도 되니까 명령 프롬프트 창을 다시 띄워주면 적용되어 있음

instant-markdown-d 패키지

명령 프롬프트 창에서 npm -g install instant-markdown-d 하여 설치
C:\Users\내아이디\AppData\Roaming\npm 아래에 설치된다.

플러그인

파일이 하나 뿐이다. 깃헙 저장소에 있는 after/ftplugin/markdown/instant-markdown.vim 파일을 자신의 vimfiles 폴더의 after/ftplugin/markdown/instant-markdown.vim으로 저장한다.

그리고 나서 *.md 파일을 편집해보면... 아무 일도 안 일어난다. 이제 고쳐보자.

4. 수정

4.1. instant-markdown-d 패키지

4.1.1. wrapper 스크립트

이 패키지를 설치한 후 실행하기 위해서 꼬박꼬박

: node.exe %APPDATA%\npm\node_modules\instant-markdown-d\instant-markdown-d

라고 실행해도 되긴 하겠지만, 그보다는 편하게

: instant-markdown-d

라고 실행할 수 있도록, 래퍼 스크립트가 %APPDATA%\npm\ 폴더에 만들어져 있다. 그런데 막상 이걸 열어보면 sh.exe 를 띄우도록 되어 있어서 동작하지 않는다. node.exe를 실행하도록 수정

[%APPDATA%\npm\instant-markdown-d.cmd 파일]

4.1.2. instant-markdown-d

길게 쓰려니 귀찮아져서, 간단히 적고 github에 올려둔다.

1) 로컬 웹서버를 띄우면서 웹 브라우저 창도 같이 띄워야 하는데, 맥의 open 대신 명령 프롬프트에서는 start를 써서 띄운다. ([커밋])

2) F5를 눌러 새로 고침하면 그냥 빈 화면만 나오게 되어 있다. 이게 불편하다. 게다가 vim으로 기존 파일을 열었을 때, 분명히 서버도 실행되었는데 브라우저에 빈 화면만 나올 때가 있는데, 이 때 F5를 눌러 갱신할 수 있으면 좋겠다 싶어서, 현재 출력 내용을 저장해두었다가 새로 브라우저에서 접속할 때 그것을 사용하게 한다. ([커밋])

3) 거의 쓸 일이 없긴 하지만, 마크다운 안에 이미지 파일이 있는 경우 현재 플러그인은 그 파일을 이 데몬이 있는 디렉토리를 기준으로 찾는다. 그것을 고쳐서 일단 현재 작업 디렉토리(vim 플러그인을 쓰게 되면 vim의 현재 작업 디렉토리가 됨) 아래에서 먼저 찾아보도록 하였다. ([커밋])

![Alt text](images/myimage.jpg)    # vim의 CWD/images/myimage.jpg 를 먼저 찾음

4) 데몬에서 로그 출력 레벨을 지정하는 구문이 경고가 뜨길래 찾아보니 최신 버전은 로그 레벨 지정을 다른 방식으로 하여야 하는가 봄. 주석 처리함. ([커밋])

5. 기타&comments

컴퓨터분류

각주:
1. 내가 써 본 것 중에는 [Haroopad]가 그나마 나았다.

이 수정본 편집일: 2016-2-21 7:14 pm (변경사항 [d])
3931 hits | Permalink | 변경내역 보기 [h] | 현재 수정본 보기 | 4 번째 수정본 소스 보기