pandoc的mac操作指南，小白版

pandoc简介

pandoc 官方网站： 链接
pandoc是标记语言转换工具，可实现不同标记语言间的格式转换，包括下面各种类型之间的转换：

pandoc没有图形界面，所以需要用命令行界面进行操作，官网给出了命令行操作的简易教程，简化整理翻译如下：

mac如何打开命令行界面：

1.在应用程序中找到Terminal并双击打开
2.使用spotlight聚焦搜索，搜Terminal

检查是否下载了pandoc

输入如下命令:

pandoc --version

如果下载成功会显示：

没有下载成功的请到官网进行下载：

相关命令行操作：

pwd查看当前目录
cd改变当前目录
cd ..变为父目录
mkdir foo在当前路径下创建子文件夹foo

技巧：
1.使用上下箭头可以查询显示已经输入过的命令，避免重复键入的麻烦
2.在输入到一半时可以使用tab，会自动补全命令

将pandoc作为filter使用，转化部分文字

输入
pandoc
然后回车就进入了输入面板，可以输入你想转换的文字，比如：

Hello *pandoc*!

- one
- two

输入完成后，输入Ctrl-D，文本会被自动转换为HTML：

<p>Hello <em>pandoc</em>!</p>
<ul>
<li>one</li>
<li>two</li>
</ul>

这是因为在pandoc没有被设置之前是从命令行上读取markdown语法作为输入，然后转化为HTML后输出到命令行界面上，我们后续也可以设置输入输出类型来对我们想要的特定格式进行转换。

比如将HTML转换为markdown：

pandoc -f html -t markdown

现在输入

<p>Hello <em>pandoc</em>!</p>

输入完成后，输入Ctrl-D，文本会被自动转换为markdown：

Hello *pandoc*!

转化文件

需要先在pandoc-test文件夹下创建一个文件，使用mac自带的TextEdit文本编辑 应用程序创建一个text类型的文件，打开TextEdit文本编辑，输入：

---
title: Test
...

# Test!

This is a test of *pandoc*.

- list one
- list two
# Test!

然后保存文件为test1.md，放入Documents/pandoc-test目录下。

在命令行界面进入到Documents/pandoc-test下（使用cd命令）。

现在我们将test1.md转换为HTML格式需要在terminal上输入如下命令：

pandoc test1.md -f markdown -t html -s -o test1.html

命令解释：
test1.md 是告诉pandoc目前想要转换的文件是test1.md
-s 选项使得pandoc会创建一个独立的文件而不是文字片段（之前直接在teminal上显示的那种）
-o test1.html是把输出放入文件test1.html中 其中-f markdown -t html其实是可以省略的，因为pandoc可以从两个文件名中推断出需要转换的两个类型。

其他类型的转换命令：
markdown 转换为latex

pandoc test1.md -s -o test1.tex

markdown 转换为pdf

pandoc test1.md -s -o test1.pdf