以下文档来自 JabinGP/mdout，如果觉得对你有帮助，不妨点个star鼓励一下~
mdout
一个Go语言实现的Markdown转PDF命令行工具，基于headless chrome，简单、可靠、易安装、可定制化、易拓展
mdout有何特点
简单
mdout会根据后缀，自动识别输入类型
mdout markdown.md
mdout local_html.html
mdout http://www.baidu.com
可靠
mdout可以完整保留你md文件里的代码格式，图片，甚至是数学公式，支持代码格式语法高亮
电脑不会如人一般等待页面加载完全再选择打印，电脑自动执行打印时页面尚未渲染完全是件非常头疼的事情，对此，mdout没有简单地使用sleep休眠机制去碰运气，而是实现了一套非常简单的同步渲染机制，即便是你有1万行的mathjax数学公式、1万行的代码语法高亮要渲染，mdout都能完美的保证你的pdf上不会有任何一个未渲染完成的元素
易安装
除了chrome，mdout不依赖于其他任何环境，你只需要选择对于系统的安装包，下载并解压即可使用，更为macOS和linux提供了一键安装脚本，为windows提供了丰富的图文教程
可定制化
mdout将每个模板独立为主题，并且支持指定输出html文件，可以很方便地自定义页面配色，自定义语法高亮配色
易拓展
mdout基于headless chrome，这使得mdout几乎兼容市面上所有能用于的前端组件，并且mdout将组件归类为主题的一部分，你同样可以输出html来调试自己的自定义拓展插件
获取和安装
由于Github下载速度实在是太过寒酸，只有30KB/s，以下的链接全部来自于阿里云服务器，尽管服务器有带宽限制，但是应对这个大小的文件还是没问题的
mdout同时支持windows，linux，macOS，但目前只支持64位的系统
- linux：mdout.linux.x86-64.tar.gz
- macOS：mdout.macOS.x86-64.tar.gz
- windows：mdout_windows_x86-64.zip
mdout已经为各平台打包了可执行文件，因此无论何种方式安装，无非就是下载可执行文件压缩包后解压缩，解压完就可以在mdout所在文件夹使用mdout了
但是为了命令行使用方便，我更推荐将mdout配置到系统的环境变量中，这样随时随地随心所欲mdout
适用于老鸟的安装方式
稍微懂点命令行的使用以下命令即可轻松安装
-
linux
wget http://112.74.177.253:8000/f/edcb3b9e460d4d18ab3f/?dl=1 tar -xvzf mdout.macOS.x86-64.tar.gz sudo mv mdout /usr/local/bin mdout install -
macOS
wget http://112.74.177.253:8000/f/100873c74622474da4d9/?dl=1 tar -xvzf mdout.linux.x86-64.tar.gz mv mdout /usr/local/bin mdout install
脚本安装
非常感谢Fisher的脚本支持! 自己日用的脚本
linux && macOS推荐使用脚本安装
-
curl方式
bash -c "$(curl -fsSL https://raw.githubusercontent.com/FisherWY/Shell/master/mdout/install_mdout.sh)" -
wget方式
bash -c "$(wget https://raw.githubusercontent.com/FisherWY/Shell/master/mdout/install_mdout.sh -O -)"
手动安装
点击前文给出的各版本链接，下载成功后解压缩，你会得到一个mdout可执行文件
windows
-
点击下载
- windows：mdout_windows_x86-64.zip
下载后使用zip工具解压缩，解压后会得到一个mdout.exe可执行文件
-
放置软件
将
mdout.exe可执行文件放置平时放软件的地方，比如D:\mdout这个文件夹里面，此时你的mdout.exe的全路径应该是D:\mdout\mdout.exe -
设置环境变量
如果不设置环境变量也可以使用，但是缺点是你需要使用cmd，powershell或者gitbash手动进入
D:\mdout才能使用mdout命令确定路径
1.jpg
设置环境变量，右键我的电脑 -> 选择属性 -> 左边的高级系统设置
选择高级 -> 点击环境变量
找到下半部分的系统变量，双击Path行
在弹出来的窗口选择新建
填入D:\mdout，然后一定要连续点完三个确定
-
检验
打开cmd，或者powershell，或者你有gitbash都ok（推荐使用命令行的windows用户都装一个gitbash），输入
mdout，看到如下输出就是成功了
linux
-
下载linux版本
点击下载
下载完成后解压tar.gz包，解压后会得到一个mdout可执行文件
-
将软件放入可执行文件库
打开终端，定位到刚刚下载的文件所在路径
cd 你的文件所在文件夹然后将可执行文件直接移动到/usr/local/bin，linux环境下需要sudo权限
sudo mv ./mdout /usr/local/bin输入密码就可以了
-
检验是否成功
输入
mdout --version，看到版本号输出就是成功了
macOS
-
下载macOS版本
点击下载
下载后使用工具解压tar.gz包，解压后会得到一个mdout可执行文件
-
将软件移动到可执行文件库
打开终端，定位到刚刚下载的文件所在路径
cd 你的mdout可执行文件所在文件夹然后将可执行文件直接移动到/usr/local/bin
mv ./mdout /usr/local/bin -
检验是否成功移动
输入
mdout --version，看到版本号输出就是成功了
使用说明
使用前提
mdout依赖于chrome浏览器，如果你的电脑已经安装了新版的chrome浏览器，无需更多配置，可以直接运行mdout，如果是旧版的chrome浏览器，建议进行升级后使用，如果还未安装chrome浏览器，请安装后再使用mdout
进行系统初始化
如果你不是使用脚本安装的，或者脚本安装不完全成功的，需要手动执行初始化，如果脚本安装成功，则跳过这一步
mdout依赖于html、css、js的模板，但是模板没有打包进程序，这是出于自定义化的考虑，执行初始化命令，程序会自动下载需要的文件到配置文件路径，至于这个路径在哪，在后面会提到，同时初始化程序执行结束后也会输出这个路径，请记住这个路径，在一些自定义和设置默认值时会使用到
mdout install
最简单的示例
mdout 文件路径
文件路径可以是相对路径
-
文件在当前目录
mdout yourfile.md -
或文件在上级目录
mdout ../yourfile.md -
文件路径也可以是绝对路径
mdout /tmp/markdown/yourfile.md
帮助文档
每个命令行程序都有帮助文档，mdout也不例外
mdout -h
mdout --help
输入文件类型
mdout支持许多输入类型，其中最普遍的就是markdown，但同样也支持html输入，url输入，但是注意，如果输入是url，不要忘记带上http:://
-
markdown
mdout yourfile.md -
html
mdout yourfile.html -
url
mdout http://www.baidu.com
输出文件类型
对于markdown输入，mdout支持输出中间过程的结果。但对于html输入或者url输入，它们的唯一输出结果就是pdf文件了
-
markdown输出pdf（输出pdf为默认选项)
mdout youtfile.md -t pdf mdout yourfile.md -
markdown输出解析后html标签（这个选项可以得到markdown解析器的解析结果）
mdout youtfile.md -t tag -
markdown输出经过处理后的完整html文件（常常用来调试主题）
mdout youtfile.md -t html
输出路径
mdout支持指定输出路径，输出文件名
你可以使用-o来指定输出路径，-o选项同样做了防呆设计，你可以指定路径但不带文件名，mdout会自动识别你输入文件的文件名和你指定的输出类型为你设置名称，但你同样可以指定路径+文件名
-
指定输出到上级文件夹，自动命名
mdout yourfile.md -o ../ -
指定输出到
/tmp/markdown文件夹，自动命名mdout yourfile.md -o /tmp/markdown -
指定输出到当前文件夹下的
badoutput.namemdout yourfile.md -o badoutput.name千万不要这么干，尽管程序不会阻止你设置你的文件名，但是使用规范的后缀是个好习惯。
-
指定输出到当前文件夹下的
goodname.pdfmdout yourfile.md -o goodname.pdf
指定主题
主题系统只对markdown输入有效
mdout有着方便易用的主题系统，你可以很自由地自定义主题，mdout预设了三套主题
- 默认主题：
default - 数学公式拓展主题：
mathjax - github风格主题：
github
你可以使用-e选项来指定主题
-
指定为github主题
mdout yourfile.md -e github -
指定为数学公式拓展主题
mdout yourfile.md -e mathjax
指定主题后上面提到的输出选项依旧可用，可以配合
-t html选项输出中间的html文件，这样可以调试主题效果，详细的说明将在自定义章节中提到
default和mathjax这两套主题的配色是一模一样的，区别在于mathjax是同时支持代码语法高亮和数学公式渲染的，而default只支持代码语法高亮
mathjax可以渲染类似这样的公式
$$\Gamma(z) = \int_0^\infty t^{z-1}e^{-t}dt\,.$$
我可以将mathjax设为默认主题并删除default，但是我没有那么做，因为default可以作为一个能满足代码语法高亮的最小模板 （当然你可能不需要代码语法高亮，这样的话default并不能算最小模板） ，基于default模板进行自定义主题将变得非常简单
至于自定义主题的教程，将在后面提到
打印页面设置
此项仅在输出pdf时有效
打印页面大小设置
mdout预设了8种页面大小，如果有更多需求，可以在issues提出
- A1 - A5
- Legal
- Letter
- Tabloid
A4为默认输出页面大小，你可以使用-f来指定输出页面的大小。同时做了防呆设计，如果你一不小心打成了大写、小写，甚至你手抽打成了大小写混合，都是可以正常识别的。可惜，防呆不防傻，你把字母都打错了就不能怪我了
-
指定输出pdf页面格式为A4（闲着没事干敲着玩）
mdout yourfile.md -f a4 -
指定输出pdf页面格式为Tabloid
mdout yourfile.md -f tabloid
打印页面方向设置
mdout只支持两种方向
- 纵向：
portrait - 横向：
landscape
默认打印页面方向为纵向，你可以使用-r指令来指定页面方向格式
-
指定输出pdf页面格式为横向
mdout yourfile.md -r landscape
打印页面边距设置
mdout支持你自定义页面边距，以英寸为单位，默认为0.4英寸
- 0.4英寸 ≈ 10cm
你可以使用-m指令来指定页面边距大小
-
指定打印边距为0.2英寸
mdout yourfile.md -m0.2 -
去除页面边距
mdout yourfile.md -m0
自定义配置文件
在配置文件安装目录下面
- macOS : /Users/你的用户名/binmdout
- linux: /home/你的用户名/binmdout
- windows: /c/users/你的用户名/binmdout
有一个conf.json文件
{
"Out":"",
"Type":"pdf",
"Theme":"default",
"PageFormat":"a4",
"PageOrientation":"portrait",
"PageMargin":"0.4"
}
包含了以上所有的可选设置，直接修改配置文件可以作为每次使用mdout的默认参数值
自定义配色
mdout有着简单易用的主题系统，跟着下面的步骤来，你可以很轻松的添加自己的自定义效果
首先打开你的配置文件所在的文件夹
在你的配置包里面会有一个conf.json文件和theme主题文件夹，其中conf.json文件是用来更改默认参数的，theme存放了你的主题包。
进入theme主题包，你可以看到默认的三个主题包
defaultmathjaxgithub
假设你现在需要自定义你的页面配色，大小，语法高亮等一切和css有关的内容，并且你想要为你的主题起名为mytheme
首先你需要完整复制default的所有内容，到default文件夹所在的目录并重命名为mytheme，此时你的theme文件夹里有四个文件夹：
defaultmathjaxgithubmytheme
然后你需要找到一个测试用例比如说这样一个markdown文件
# 测试标题
## 测试二级标题
### 测试三级标题
#### 测试四级标题
- 测试无序列表1
- 测试无序列表2
1. 测试有序列表1
2. 测试有序列表2
- 测试嵌套
1. 测试嵌套第二次
- 测试嵌套第三层
> 测试引用
测试表格
| 标题1 | 标题2 | 标题3 |
| ----- | ---- | ---- |
| 文本1 | 文本2 | 文本3 |
| 文本4 | 文本5 | 文本6 |
**这是加粗的文字**
*这是倾斜的文字*
***这是斜体加粗的文字***
~~这是加删除线的文字~~
[测试超链接](https://github.com/JabinGP/mdout)
`测试代码段高亮`
测试代码块高亮
package main
import (
"fmt"
)
func main() {
fmt.Println("Hello Mdout")
}
紧接着使用mdout yourfile.md -e mytheme -t html来获取这个markdown文件指定mytheme主题的html输出结果，用编辑器打开html文件，同时用chrome打开html文件，可以看到，页面已经自动引入了你刚刚创建的自定义主题包css
<!-- 添加页面样式 -->
<link rel="stylesheet" href="/Users/jabin/binmdout/theme/mytheme/css/page.css"/>
<!-- 添加hljs样式 -->
<link rel="stylesheet" href="/Users/jabin/binmdout/theme/mytheme/css/hljs.css"/>
主题配色分为两个文件，一个是页面配色css文件，一个是代码高亮的css文件
如果你要修改页面配色，只需要一边开着浏览器，一遍打开刚刚主题包里面的
mytheme->css->page.css修改，然后刷新浏览器查看结果
或者你想更改语法高亮的配色，由于mdout依赖于hljs，你只需要去hljs官网下载你喜欢的主题包，然后替换mytheme->css->hljs.css里的内容就可以了
如果你完成了你的主题修改，你可以将刚刚生成的html删除，或者你想留做自己动手的纪念也是可以的
最后，你可以使用mdout yourfile.md -e mytheme来指定使用你的自定义主题啦，或者你可以在前面提到过的conf.json里面配置默认使用你的mytheme主题
如果觉得对你有帮助，点个star吧！
