3 번째 수정본
윈도우 vim 에서 markdown 파일 실시간 미리보기
-
- 1. 개요
-
- 2. 맥과 리눅스의 경우
-
- 3. 필요한 것들 설치
-
- 4. 수정
-
-
- 4.1. instant-markdown-d 패키지
-
5. 기타&comments
-
vim 플러그인 중에 vim-instant-markdown(Github: [1])이란 게 있는데, 이걸 설치하고 vim으로 마크다운 형식의 파일(*.md, *.markdown)을 열면 웹브라우저 창이 열리면서 현재 편집 중인 마크다운 파일을 렌더링한 결과물을 실시간으로 보여준다.
문제는 이게 맥과 리눅스에서만 동작하고 윈도우에서는 안 된다는 건데... 윈도우에서 "미리보기가 지원되며 실시간으로 반영되며, 코드 블록과 테이블 문법도 잘 지원되면서 이왕이면 신택스 하일라이트도 되고 무료인" 마크다운 편집기를 찾다 찾다 못 찾아서... 이 플러그인을 윈도우에서 쓸 수 없을까 하며 토요일 하루밤을 삽질로 보내었다.
문제는 이 플러그인을 쓰는 과정이
- 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.1. instant-markdown-d 패키지
이 패키지를 설치한 후 실행하기 위해서 꼬박꼬박
-
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
파일:
@IF EXIST "%~dp0\/bin/sh.exe" (
"%~dp0\/bin/sh.exe" "%~dp0\node_modules\instant-markdown-d\instant-markdown-d" %*
) ELSE (
echo %~dp0
@SETLOCAL
@SET PATHEXT=%PATHEXT:;.JS;=;%
REM%~dp0%*
node.exe "%~dp0\node_modules\instant-markdown-d\instant-markdown-d" %*
)
5. 기타&comments
컴퓨터분류