markdown转为html及pdf


markdown转为html

markdown转html比较容易些,有很多方法都可以做到。


1. 通过markdown编辑器导出

linux下常用的markdown编辑器有retext,haroopad等,这些软件都支持自定义css并导出html。以上软件的安装详见linux环境下Markdown编辑器汇总


2. 使用github上的开源项目

github上有许多优秀的开源项目都可以将markdown转为各种样式的html页面。


3. 使用pandoc

pandoc是进行文件类型转换的瑞士军刀,初次接触的同学可以体验下 Pandoc Demos。更多信息请查看Pandoc User’s Guide

将markdown转为html很简单,直接执行以下命令即可。其中,”template.css”是自定义的模板。
pandoc README.md -c template.css -o README.html


markdown转为pdf


1. markdown->html->pdf

可以先将markdown转为html,具体方式见上小节。之后在浏览器中打开html并打印为pdf即可,不过这样得到的pdf总是有点模糊。

为知笔记支持自定义markdown格式(即自定义css),并支持导出html及pdf,效果堪称完美。见下图。更多markdown样式的模板详见markdown-css

wiz-m2p


2. 使用pandoc

使用pandoc将markdown转为pdf需要首先安装LaTex,linux下建议安装TexLive,具体安装过程见Fedora21安装TexLive2015及Texstudio

之后使用如下命令进行转换,
pandoc test.md -o test.pdf --latex-engine=xelatex

打开输出文件却发现中文没有显示,那是因为Latex默认不支持中文,所以添加参数来指定字体为宋体,如下所示。更多参数详见Variables for LaTeX
pandoc test.md -o test.pdf --latex-engine=xelatex -V mainfont=SimSun

这次的输出文件没有断行,此时必须使用模板了,首先输入一下命令导出默认模板
pandoc -D latex > template.tex

参考pm-template.latex,将”template.tex“文件中\else % if luatex or xelatex$if(mainfont)$的部分修改为如下所示:

\else % if luatex or xelatex
    % SUPPORT for Chinese  
  \usepackage{fontspec}  % 允许设定字体
  \usepackage{xeCJK}    % 分开设置中英文字型
  \setCJKmainfont{SimSun}  % 设定中文字型
  \setmainfont{SimSun}   % 设定英文字型
  \setromanfont{SimSun}  % 字型
  \setmonofont{SimSun}
  \linespread{1.2}\selectfont   % 行距
  \XeTeXlinebreaklocale "zh"  % 针对中文自动换行
  \XeTeXlinebreakskip = 0pt plus 1pt % 字与字之间加入0pt至1pt的间距,确保左右对整齐
  \parindent 0em    % 段落缩进
  \setlength{\parskip}{20pt}  % 段落之间的距离
  \ifxetex
    \usepackage{xltxtra,xunicode}
  \fi
  \defaultfontfeatures{Mapping=tex-text,Scale=MatchLowercase}
  \newcommand{\euro}{}
$if(mainfont)$

之后,执行如下命令,即可得到比较完美的pdf了。
pandoc test.md -o test.pdf --latex-engine=xelatex --template=template.tex

可能会出现问题”pandoc “cannot parse yaml header” when converting md to pdf“,参考stackoverflow上的解决办法,在执行命令时,加上参数--from markdown-yaml_metadata_block即可,不过最好还是将markdown中的”—“去掉。


补充

在上面的基础之上,可以进行适当修改以形成不同的模板,我将我的几个模板放在了github上,地址–·pandoc-m2p-template

朴素型:
m2p_plain

Style1:
m2p-style1


参考文档

【1】神器Pandoc的安装与使用
【2】让pandoc输出pdf时支持中文

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章