使用Pandoc命令将Markdown格式文件转换为HTML格式文件

一、Pandoc命令介绍

Pandoc是一个强大的格式语言转换工具，被称为该领域的“瑞士军刀”。比如可用Pandoc命令将Markdown格式文件转换成HTML格式文件。

二、具体转换命令

具体转换命令如下：

pandoc --standalone --self-contained --css pandoc.css src.md --output target.html

以上转换命令中选项含义介绍如下。
1、“–standalone”
为目标格式文件增加合适的“header”和“footer”。如果目标格式是“HTML”，那么通过该选项可解决“由于未设置合适的字符编码，而导致的乱码问题”。
2、“–self-contained”
如果目标格式是“HTML”，那么可得到如下效果：在转换得到目标HTML文件的过程中，会将依赖的“脚本，CSS，图片，视频”等文件的内容内嵌到目标HTML文件中。
3、“–css pandoc.css”
使得目标格式文件最后使用“pandoc.css”文件作为CSS文件，否则，使用默认的CSS文件有可能只能得到丑陋的展现效果。
4、“src.md”
原文件，从中也可以知道原文件的格式为“Markdown”。
5、“–output target.html”
指定目标文件路径，从中也可以知道目标文件的格式为“HTML”。

三、选用的CSS文件

使用Pandoc命令将Markdown格式文件转换成HTML格式文件，目标HTML文件如果使用默认的CSS文件，那么展现效果非常丑陋，因而需要使用独立的CSS文件。
本人使用的CSS文件内容如下，来自于链接：

/* * I add this to html files generated with pandoc. */

html { font-size: 100%; overflow-y: scroll; -webkit-text-size-adjust: 100%; -ms-text-size-adjust: 100%; }

body { color: #444; font-family: Georgia, Palatino, 'Palatino Linotype', Times, 'Times New Roman', serif; font-size: 12px; line-height: 1.7; padding: 1em; margin: auto; max-width: 42em; background: #fefefe; }

a { color: #0645ad; text-decoration: none; }

a:visited { color: #0b0080; }

a:hover { color: #06e; }

a:active { color: #faa700; }

a:focus { outline: thin dotted; }

*::-moz-selection { background: rgba(255, 255, 0, 0.3); color: #000; }

*::selection { background: rgba(255, 255, 0, 0.3); color: #000; }

a::-moz-selection { background: rgba(255, 255, 0, 0.3); color: #0645ad; }

a::selection { background: rgba(255, 255, 0, 0.3); color: #0645ad; }

p { margin: 1em 0; }

img { max-width: 100%; }

h1, h2, h3, h4, h5, h6 { color: #111; line-height: 125%; margin-top: 2em; font-weight: normal; }

h4, h5, h6 { font-weight: bold; }

h1 { font-size: 2.5em; }

h2 { font-size: 2em; }

h3 { font-size: 1.5em; }

h4 { font-size: 1.2em; }

h5 { font-size: 1em; }

h6 { font-size: 0.9em; }

blockquote { color: #666666; margin: 0; padding-left: 3em; border-left: 0.5em #EEE solid; }

hr { display: block; height: 2px; border: 0; border-top: 1px solid #aaa; border-bottom: 1px solid #eee; margin: 1em 0; padding: 0; }

pre, code, kbd, samp { color: #000; font-family: monospace, monospace; _font-family: 'courier new', monospace; font-size: 0.98em; }

pre { white-space: pre; white-space: pre-wrap; word-wrap: break-word; }

b, strong { font-weight: bold; }

dfn { font-style: italic; }

ins { background: #ff9; color: #000; text-decoration: none; }

mark { background: #ff0; color: #000; font-style: italic; font-weight: bold; }

sub, sup { font-size: 75%; line-height: 0; position: relative; vertical-align: baseline; }

sup { top: -0.5em; }

sub { bottom: -0.25em; }

ul, ol { margin: 1em 0; padding: 0 0 0 2em; }

li p:last-child { margin-bottom: 0; }

ul ul, ol ol { margin: .3em 0; }

dl { margin-bottom: 1em; }

dt { font-weight: bold; margin-bottom: .8em; }

dd { margin: 0 0 .8em 2em; }

dd:last-child { margin-bottom: 0; }

img { border: 0; -ms-interpolation-mode: bicubic; vertical-align: middle; }

figure { display: block; text-align: center; margin: 1em 0; }

figure img { border: none; margin: 0 auto; }

figcaption { font-size: 0.8em; font-style: italic; margin: 0 0 .8em; }

table { margin-bottom: 2em; border-bottom: 1px solid #ddd; border-right: 1px solid #ddd; border-spacing: 0; border-collapse: collapse; }

table th { padding: .2em 1em; background-color: #eee; border-top: 1px solid #ddd; border-left: 1px solid #ddd; }

table td { padding: .2em 1em; border-top: 1px solid #ddd; border-left: 1px solid #ddd; vertical-align: top; }

.author { font-size: 1.2em; text-align: center; }

@media only screen and (min-width: 480px) {
  body { font-size: 14px; }
}
@media only screen and (min-width: 768px) {
  body { font-size: 16px; }
}
@media print {
  * { background: transparent !important; color: black !important; filter: none !important; -ms-filter: none !important; }

  body { font-size: 12pt; max-width: 100%; }

  a, a:visited { text-decoration: underline; }

  hr { height: 1px; border: 0; border-bottom: 1px solid black; }

  a[href]:after { content: " (" attr(href) ")"; }

  abbr[title]:after { content: " (" attr(title) ")"; }

  .ir a:after, a[href^="javascript:"]:after, a[href^="#"]:after { content: ""; }

  pre, blockquote { border: 1px solid #999; padding-right: 1em; page-break-inside: avoid; }

  tr, img { page-break-inside: avoid; }

  img { max-width: 100% !important; }

  @page :left { margin: 15mm 20mm 15mm 10mm; }

  @page :right { margin: 15mm 10mm 15mm 20mm; }

  p, h2, h3 { orphans: 3; widows: 3; }

  h2, h3 { page-break-after: avoid; }
}

参考文献：
[1]https://gist.github.com/killercup/5917178
[2]https://gist.github.com/ryangray/1882525
[3]https://zh.wikipedia.org/wiki/Pandoc