Pandoc+revealjs 将Markdown转成PPT

Markdown 语言在 2004 由约翰·格鲁伯创建,是一种轻量级标记语言,可以使用纯文本格式编写文档,并能导出为 HTML 、Word、图像、PDF、Epub 等多种格式的文档,可以做到“一次编写,多次使用”
Pandoc则可以将文档在 Markdown、LaTeX、reStructuredText、HTML、Word docx 等多种标记格式之间相互转换,并支持输出 PDF、EPUB、HTML 幻灯片等多种格式。该程序被称为格式转换界的 “瑞士军刀”
Reveal.js 是一个使用 HTML 语言制作演示文稿的 Web 框架, 它可以把 Markdown 文件转为类似 PPT 的演示文稿,轻快省力,减少排版上的时间,更专于文字内容;同时,也获得 PPT 所不具有的灵活性

环境安装

  1. 首先根据系统选择需要下载的安装包安装,windows版下载完成后双击安装一路默认即可,验证安装是否成功可以
    使用命令行 输入: > pandoc -v,出现下图所示类似结果,表示安装成功。
    check.PNG
  2. 到github 上下载 revealjs(或者命令行 git clone https://github.com/hakimel/reveal.js)
  3. 将要转换的md文档与reveal.js 文件夹放在同一目录下,然后使用命令 pandoc slides.md -o index.html -t revealjs -s
    ,即可在同级目录下得到-o 后面的文件名称的html文件,即是最后的实现了类似 PPT 的演示文稿。
  4. 打开 生成的 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

结果如下:


result.gif

参考资料:

[1] https://www.jianshu.com/p/0e0abc6feeb3
[2] https://www.pandoc.org/MANUAL.html

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,875评论 6 496
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,569评论 3 389
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 160,475评论 0 350
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,459评论 1 288
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,537评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,563评论 1 293
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,580评论 3 414
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,326评论 0 270
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,773评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,086评论 2 330
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,252评论 1 343
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,921评论 5 338
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,566评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,190评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,435评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,129评论 2 366
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,125评论 2 352

推荐阅读更多精彩内容