#slide #presentation #markdown #cli

app deck

一个将 Markdown 文档转换为 HTML 演示文稿的命令行工具

3 个版本 (破坏性更新)

0.3.0 2020 年 4 月 16 日
0.2.0 2019 年 3 月 17 日
0.1.0 2019 年 3 月 11 日

#13 in #slide

MIT 许可证

24KB
605

Build Status Crate Status Docs Status

Deck

Deck 是一个命令行工具,可以将 Markdown 文档转换为 HTML 演示文稿。

输入

幻灯片以 Markdown 编写。水平线(---)用于分隔每个幻灯片。

用法

构建

一个 Markdown 文件可以通过单个文件中的单个命令转换为 HTML 演示文稿。默认情况下,生成的 HTML 包含一些内联 CSS 和 JavaScript,以正确渲染幻灯片。如果您想进一步自定义输出,可以使用 --css--js 选项传递额外的 CSS 和 JavaScript 文件。生成的文档可以在大多数现代浏览器中打开。

deck build < slides.md > slides.html

服务

您还可以使用内置服务器提供 Markdown 幻灯片。以下命令将演示文稿提供给 https://127.0.0.1:8000/slides

deck serve slides.md -p 8000

在编写您的演示文稿时,您可能需要查看生成的 HTML 演示文稿的演变。通过在先前的命令中添加 - 和将 ?watch=true 添加到先前的 URL,将确保在修改 Markdown 幻灯片、自定义 CSS 或自定义 JavaScript 时网页会重新加载。

语法高亮

语法高亮可以以多种方式自定义。首先,buildserve 命令都允许您使用 --theme 选项选择不同的主题。默认情况下,只有少数几个主题可用,如此处列出。

deck build --theme InspiredGitHub < slides.md > slides.html

此外,执行所有代码高亮重任务的 syntect 包能够加载所有 TextMate 和 Sublime Text .tmTheme 颜色方案。为了加载本地主题,您必须首先将其目录添加到二进制文件将查找兼容主题的路径列表中,然后使用 --theme 选择它。假设 gruvbox.tmTheme 位于 ./themes 目录下,命令调用可能如下所示:

deck build --theme-dir ./themes --theme gruvbox < slides.md > slides.html

待办事项

  • 演讲者备注
  • 计时器

依赖关系

~22-35MB
~561K SLoC