Markdown 语言在 2004 由约翰·格鲁伯创建,是一种轻量级标记语言,可以使用纯文本格式编写文档,并能导出为 HTML 、Word、图像、PDF、Epub 等多种格式的文档,可以做到“一次编写,多次使用”。
Pandoc则可以将文档在 Markdown、LaTeX、reStructuredText、HTML、Word docx 等多种标记格式之间相互转换,并支持输出 PDF、EPUB、HTML 幻灯片等多种格式。该程序被称为格式转换界的 “瑞士军刀”。
Reveal.js 是一个使用 HTML 语言制作演示文稿的 Web 框架, 它可以把 Markdown 文件转为类似 PPT 的演示文稿,轻快省力,减少排版上的时间,更专于文字内容;同时,也获得 PPT 所不具有的灵活性
环境安装
- 首先根据系统选择需要下载的安装包安装,windows版下载完成后双击安装一路默认即可,验证安装是否成功可以
使用命令行 输入:> pandoc -v
,出现下图所示类似结果,表示安装成功。
- 到github 上下载 revealjs(或者命令行 git clone https://github.com/hakimel/reveal.js)
- 将要转换的md文档与reveal.js 文件夹放在同一目录下,然后使用命令
pandoc slides.md -o index.html -t revealjs -s
,即可在同级目录下得到-o 后面的文件名称的html文件,即是最后的实现了类似 PPT 的演示文稿。 - 打开 生成的 index.html ,可以使用如下按键进行控制:
按空格键来跳转到下一页
按 Esc 键,进入幻灯片概览
按 b ,暂停幻灯片(页面变黑息屏)
按 s ,进入 演讲者备注视图
如果需要在别的地方使用该html文件,需要连同reveal.js 文件夹一起打包
::: notes
不知为啥pandoc在github 上 一直下载失败,只能从别的渠道下载,防止再次出现这种问题,善良的我已经把pandoc 软件和revealjs 放到云盘上。
链接:https://pan.baidu.com/s/1TOVtqsWyRIM4YGJ4kqw_zA
提取码:ncvr
复制这段内容后打开百度网盘手机App,操作更方便哦
:::
pandoc使用
pandoc 将Markdown转成PPT 本质上还是转换成html,而这个html文件实现了ppt的效果。
pandoc的一般命令格式为:
pandoc <files> <options>
其中 ,<files> 为输入的文件。而 <options> 为参数选项。主要的参数选项有:
-f <format>、-r <format>:指定输入文件格式,默认为 Markdown;
-t <format>、-w <format>:指定输出文件格式,默认为 HTML;
-o <file>:指定输出文件,该项缺省时,将输出到标准输出;
--highlight-style <style>:设置代码高亮主题,默认为 pygments;
-s:生成有头尾的独立文件(HTML,LaTeX,TEI 或 RTF);
-i : 渐进显示的列表
--list-highlight-styles:列出支持的代码高亮主题;
-V 接需要用的变量
-v、--version:显示程序的版本号;
-h、--help:显示程序的帮助信息。
目前Pandoc包含了对五种HTML幻灯片框架的支持:
- DZSlides
- Slidy
- S5
- Slideous
- reveal.js
当然,你实际上可以使用任何喜欢的幻灯片框架,只要让Pandoc 使用-t选项指定格式即可,前提是你提前下载了框架。这里我们使用 reveal.js 类型的幻灯片为例。
修改主题
格式如:
pandoc slides.md -o slides.html -t revealjs -s -V theme=beige
主要的主题背景有:
default:(默认)深灰色背景,白色文字
beige:米色背景,深色文字
sky:天蓝色背景,白色细文字
night:黑色背景,白色粗文字
serif:浅色背景,灰色衬线文字
simple:白色背景,黑色文字
solarized:奶油色背景,深青色文字
使用变量控制显示效果
格式如:
pandoc slides.md -o slides.html -t revealjs -s -V controls=true
支持的变量有:
controls: true, // 是否在右下角展示控制条
progress: true,// 是否显示演示的进度条
slideNumber: false, // 是否显示当前幻灯片的页数
history: false,// 是否将每个幻灯片改变加入到浏览器的历史记录中去
keyboard: true, // 是否启用键盘快捷键来导航
overview: true, // 是否启用幻灯片的概览模式
center: true, // 是否将幻灯片垂直居中
touch: true, // 是否在触屏设备上启用触摸导航
loop: false, // 是否循环演示
rtl: false, // 是否将演示的方向变成 RTL
fragments: true, // 全局开启和关闭碎片
help: true,// 当按下键盘上的?问号键时,是否显示帮助
autoSlide: 0,// 两个幻灯片之间自动切换的时间间隔(毫秒),当设置成 0 的时候则禁止自动切换,该值可以被幻灯片上的 ` data-autoslide` 属性覆盖
autoSlideStoppable: true,// 当遇到用户输入的时候停止切换
mouseWheel: false, // 是否启用通过鼠标滚轮来导航幻灯片
hideAddressBar: true, // 是否在移动设备上隐藏地址栏
previewLinks: false, // 是否在一个弹出的 iframe 中打开幻灯片中的链接
ransition: 'default', // 切换过渡效果none/fade/slide/convex/concave/zoom
transitionSpeed: 'default',// 过渡速度 ,default/fast/slow
backgroundTransition: 'default', //全屏幻灯片背景的过渡效果 none/fade/slide/convex/concave/zoom
viewDistance: 3, // 除当前可见的之外的幻灯片数量
parallaxBackgroundSize: '', // // 视差背景尺寸,如"2100px 900px"
幻灯片生成规则
-
---
将总是开始新的幻灯片。即可以使用分割线来强行生成新的幻灯片。 - 幻灯片级别(即用来分页的标题级别,可以使用
---slide-level
来改变 )以上的标题会创建 "标题幻灯片",其中仅包含章节标题,并有助于将幻灯片分为几部分。 这些标题下的非幻灯片内容将包含在标题幻灯片中(用于HTML幻灯片显示)或后续具有相同标题的幻灯片中(用于投影机)。 - 幻灯片级别的标题,始终会开始创建新幻灯片,并作为标题显示
- 幻灯片级别以下的标题,只会在幻灯片中显示成标题。
如下:
%标题
%作者
%日期
## 上述% 元信息说明
文本开头需要包含三行以%打头的元信息:这将生成 幻灯片入口:这些百分号 % 将单独生成幻灯片入口(切记上下行之间不能有空格)
## 级别说明
- 如果是一级标题,紧接着的有内容和无内容时生成的ppt 样式是不一样的
- 如果所有的1级标题下无内容,则以二级标题为 分页依据,
且一级标题独立成页
- 有文字的时候,1级标题作为分页依据,其后内容作为内容
## 一级标题,紧接着的无内容举例:
```
# level1 A
## leve2 A1
- listA11
- listA12
## leve2 A2
- listA21
- listA22
# level1 B
## level2 B
- list b1
- list b2
```
上面会生成5页ppt,每个标题级分别占一页,其中前三个一组,竖向分页,后两个一组竖向分页, # level1 A 和# level1 B 横向划分
## 一级标题,紧接着的有内容举例:
```
# level1 A
- list l1a1
- list l1a2
## leve2 A1
- listA11
- listA12
## leve2 A2
- listA21
- listA22
# level1 B
- list l1b1
## level2 B
- list b1
- list b2
```
上面会生成2页ppt, # level1 A 和# level1 B 横向划分,分别作为一页ppt,其后面的作为内容
## 这是一个幻灯片级别的标题 {data-background-color="#ff0000"}
- 幻灯片级别标题后 {data-background-color="#ff0000"} 可修改当前页背景
- 类似 的还有:
* data-background-image
* data-background-video
* data-background-iframe
## 暂停
`...` 可以暂停显示,这里是暂停之前
. . .
`...` 可以暂停显示,这里是暂停之后
## 强制分页
- `---` 可以强制分页
- 这里是`---`强制分页前
---
这里是`---`强制分页后
## 备注
- 这里是备注,演讲者模式(按S进入演讲者模式)时可以显示
::: notes
这里是备注,演讲者模式(按S进入演讲者模式)时可以显示
:::
## 列表逐行显示,按空格显示
::: incremental
- 列表项1
- 列表项2
:::
## 水平展示列表
:::::::::::::: {.columns}
::: {.column width="40%"}
第一列
:::
::: {.column width="60%"}
第2列
:::
::::::::::::::
## END
结果如下:
参考资料:
[1] https://www.jianshu.com/p/0e0abc6feeb3
[2] https://www.pandoc.org/MANUAL.html