2017년 2월 14일 화요일

마크다운(markdown) 문서를 파이어폭스로 열기

리눅스에서 종종 프로그램 설치를 하면서 README.md라는 이름의 파일을 종종 접하게 된다. 처음에는 이것이 어떤 성격의 문서인지를 전혀 몰랐었다. vi로 열면 흔히 보는 도움말 텍스트 파일인데 왜 확장자가 .md인 것일까? 조사를 한 결과 마크다운(markdown)이란 문법으로 만들어진 문서라는 것을 알게 되었다. 위키 문서를 작성할 때 쓰는 문법과 마찬가지로 매우 간단하고, html로 전환하기도 쉽다고 한다.

그렇다고 해서 .md 문서를 vi나 gedit, 또는 ooffice --writer로 열어서 보기는 아깝다. 텍스트의 서식이 제대로 나타나지 않는 것은 물론, 하이퍼링크를 클릭하지 못하기 때문이다. 마크다운 전용 뷰어를 설치하여 쓰거나, html로 전환하여 파일로 저장한 뒤 웹 브라우저에서 여는 것이 바람직하다.

리눅스용 마크다운 뷰어를 찾아보았지만 눈에 썩 들어오는 것이 없다. Markdown.pl이라는 markdown to html converter가 있어서 마크다운 문서를 파일로 쓰거나 표준 출력으로 내보내는 것이 가능하다. 그러면 표준 출력으로 나오는 html 코드를 파이어폭스로 파이핑할 수 없을까? 구글링을 해 보았으나 크롬이나 파이어폭스가 이런 처리를 해 준다는 정보는 없다. 다만 browser라는 유틸리티가 표준입력으로 받은 html 코드를 웹브라우저로 띄워주는 역할을 할 수 있다고 한다. browser는 linuxbrew 환경으로 설치하면 된다.
$ brew install browser
$ browser
Usage: browser
    pipe html to a browser

$ echo '&lth1&gthi mom!&lt/h1&gt' | browser
$ ron -5 man/rip.5.ron | browser
$ Markdown.pl FALCON-integrate/README.md | browser
/home/hyjeong/.linuxbrew/bin/browser:22: warning: Insecure 
world writable dir /usr/local/apps/amos-2.0.8 in PATH, mode 040777

짜잔~! 드디어 파이오폭스에서 문서가 나타난다.


이 과정을 굳이 블로그로 남기는 이유는? 그러지 않으면 내가 Markdown.pl과 browser를 설치했었는지, 사용법은 어떻게 되는지를 기억하지 못하기 때문이다.


댓글 없음: