03
用文字、代码、列表与链接组织内容。
### 页内标题
*斜体* **粗体** ***粗斜体***
`行内代码`
\*原样星号\*
斜体 粗体 粗斜体
行内代码
*原样星号*
用空行分段;行末两个空格可手动换行。
```ts
function slideTitle(title: string) {
if (!title.trim()) return 'Cinderfolio';
return title.trim();
}
```
三个反引号包裹代码,后接语言名,如 ts、python。
function slideTitle(title: string) {
if (!title.trim()) return 'Cinderfolio';
return title.trim();
}
代码围栏是标准 Markdown;Shiki 负责语法高亮,复用 Cinderfolio 配色。
- 研究问题
- 数据与约束
1. 建模
2. 验证
> 先给结论,再展示证据。
先给结论,再展示证据。
-、+ 与 1. 直接显示;*、1) 在 Marp 中用于分步。
[Marp 官网](https://marp.app/)

链接使用 [文字](地址),图片在前面加 !。
图片说明用作替代文本;尺寸设置见“原生 Marp”。
04
用表格、公式、算法与图表补充结构化表达。
| 方法 | 延迟 | 得分 |
| :--- | :---: | ---: |
| 基线 | 12 ms | 80 |
| 改进 | 8 ms | 92 |
~~旧结论~~ 更新后的结论。
==高亮== 重点信息。
x^2^ 与 H~2~O
| 方法 | 延迟 | 得分 |
|---|---|---|
| 基线 | 12 ms | 80 |
| 改进 | 8 ms | 92 |
旧结论 更新后的结论。
高亮 重点信息。
x2 与 H2O
冒号控制列对齐;== 高亮,^ 上标,~ 下标,~~ 删除线。
行内公式:$E = mc^2$
$$
\sum_{i=1}^{n} i
= \frac{n(n+1)}{2}
$$
行内公式:
$…$ 用于行内,$$…$$ 用于独立公式。
```pseudo
\begin{algorithm}
\caption{Quicksort}
\begin{algorithmic}
\PROCEDURE{Quicksort}{$A, p, r$}
\IF{$p < r$}
\STATE $q = $ \CALL{Partition}{$A, p, r$}
\STATE \CALL{Quicksort}{$A, p, q - 1$}
\STATE \CALL{Quicksort}{$A, q + 1, r$}
\ENDIF
\ENDPROCEDURE
\end{algorithmic}
\end{algorithm}
```
Algorithm 1 Quicksort
1:procedure Quicksort(
2:if
3:
4:Quicksort(
5:Quicksort(
pseudocode.js 负责算法排版;公式跟随文稿的 MathJax / KaTeX 设置。
```mermaid
flowchart TD
A[研究问题] --> B[方法与证据]
B --> C[结论]
```
使用 mermaid 代码围栏。
Pele 将 Mermaid 语法渲染为 SVG,配色跟随亮暗主题。
> [!IMPORTANT]
> **核心结论:** 分层处理减少了重复计算。
核心结论: 分层处理减少了重复计算。
> [!NOTE]
> 结果基于相同数据与硬件。
说明
结果基于相同数据与硬件。
> [!TIP]
> 先讲结论,再展示证据。
> [!WARNING]
> 留意方法的适用范围。
> [!CAUTION]
> 不将相关性当作因果。
提示
先讲结论,再展示证据。
注意
留意方法的适用范围。
警告
不将相关性当作因果。
任务列表与脚注尚未启用,以下仅展示写法。
- [x] 完成实验
- [ ] 整理结论
使用勾选状态记录待办事项。
结论的补充说明[^note]。
[^note]: 数据与方法的来源。
脚注显示在正文中,不同于演讲备注。
05
用指令、图片语法与分步列表组织演示。
---
marp: true
theme: cinderfolio
size: 16:9
paginate: true
transition: fade 300ms
math: mathjax
header: 研究汇报
footer: 作者 · 单位
---
页眉、页脚与页码统一设置。
fade 300ms:全篇淡入淡出。
<!--
header: >
[快速开始](#2)
[特性展示](#5)
[标准 Markdown](#9)
[扩展 Markdown](#14)
**[原生 Marp](#22)**
footer: Cinderfolio · 作者
-->
修改后延续到后页;用 加粗 标记当前章节。
#n 指向实际第 n 页,与页脚编号无关。
<!--
_class: cover
_header: ""
_footer: ""
_paginate: skip
-->
# 报告标题 <small>副标题</small>
作者
单位
日期
_class: cover 使用封面预设。_header: "" 清空页眉。_footer: "" 清空页脚。_paginate: skip 隐藏且不计数。_paginate: false 隐藏但仍计数。带 _ 的设置仅本页有效,后页自动恢复。
将 <style scoped> 写在需要调整的页内,仅当前页生效。
<style scoped>
pre code {
font-size: 24px;
}
</style>
```python
print("Cinderfolio")
```
<style scoped>
figure.cinderfolio-pele > svg {
width: 320px;
height: auto;
}
</style>
```mermaid
flowchart LR
A[输入] --> B[输出]
```


figure 与 figcaption 是原生 HTML;不需要图注时可直接放图片。
bg left / right 半页背景尚未完整适配;图文混排建议使用 cf-cols。
** 提出研究问题
* 展示方法与证据
1)1) 归纳结论
2) 说明局限
→ / 空格前进,← 返回;-、+、1. 直接全部显示。
普通 <!-- 注释 --> 作为演讲备注,不显示在正文。
本演示也是主题用法示例。封面使用 cover,h1 自身居中,可选副标题写在标题内的 small 中;布局只需主题 CSS,作者、单位和日期均可省略。
CLI 提供完整渲染与资源;VS Code 扩展通过主题 CSS 提供编辑预览。
npm ci 安装锁定的 Marp CLI、Pele、Shiki。marp 一次性构建后退出;可选的 marp-preview 复用原生 watch / preview,--no-open 可只监听,Ctrl+C 停止。交付前停止监听,再运行 marp。文稿在原目录输出 HTML,素材不移动,字体引用 Cinderfolio 本地文件。网页双比例示例、资源打包与同源状态同步由网站另外接入。CLI 扩展入口:https://github.com/marp-team/marp-cli#engine
Marp for VS Code 3.6.1 的接入入口是 markdown.marp.themes,支持主题 CSS 与原生 h1 / small 版式;自定义引擎和本地字体通过 CLI 加载。来源:https://github.com/marp-team/marp-vscode#use-custom-theme-css
这一页本身就是 transition 示例:编号、章节名和一句引导。标题与强调线保持固定,删除可选文字不改变位置。
第 1 页展示真实封面,五个章节入口展示真实过渡页。封面与过渡页强调线距顶部 400px;封面 h1 自身居中于上部。可用 <br> 手动换行。封面清空页眉页脚、跳过编号的完整写法见本文件第一页。
本页本身使用 compact,下一页自动恢复常规。紧凑布局仅调整正文,标题、强调线与正文起点保持不动,图像高度仍由作者选择。
cf-cols 可放多个 cf-col;本页两列扣除间距后按 3:2 分配,左栏左上对齐、右栏整体居中。Mermaid block-beta 由 Pele 渲染九宫格:t/m/b 表示上中下,l/c/r 表示左中右,对应 cf-align-*。cf-col 独立使用就是全宽组,本页上方居中、下方靠右;HTML 容器内写 Markdown 时,标签与内容之间保留空行。垂直对齐在另一栏更高或组有额外高度时才有可分配空间;任意权重或额外高度可用 style scoped 设置 flex-grow 或 min-height。
本章以 CommonMark 核心语法为准;Marp 对分页与列表标记的特殊处理放在原生 Marp 章。参考:https://spec.commonmark.org/
标题、强调、行内代码与反斜杠转义属于 CommonMark 核心语法。Marp 还会把普通段落内的换行转换为 br;本主题约定封面 h1、页题 h2、页内标题 h3 起,原生 Markdown 支持 h1–h6。独立横线会被 Marp 用于分页,见原生 Marp 章。
CommonMark 定义代码围栏及其语言信息,不规定具体的高亮方式。Cinderfolio 在构建期使用 Shiki 输出带语法颜色和字形的 HTML,保留 Marp 原生代码自动缩放。普通代码、Mermaid 图表和论文式伪代码共享围栏写法,后两者的扩展渲染分别在下一章介绍。参考:https://spec.commonmark.org/0.31.2/#fenced-code-blocks
CommonMark 的 *、-、+ 可创建无序列表,1. 和 1) 可创建有序列表。Marp 的 * 与 1) 启用分步显示;本页用 - 与 1. 一次展示完整列表。
本页图片使用纯 Markdown 图片语法,没有 w/h/bg 等 Marp 扩展;宽度仅受主题的横向防溢出限制。图片使用现有获准资源,来源与许可见 assets/SOURCE.json。链接与图片也可使用引用式定义,参考:https://spec.commonmark.org/
扩展 Markdown 不是单一标准。当前 Marp Core 4.4.0 支持 GFM 表格、删除线与数学公式;Mermaid 图表由 Pele 渲染,论文式伪代码由 pseudocode.js 排版,二者通过 Cinderfolio 的围栏扩展接入。标注块、高亮与上下标也由 Markdown 扩展提供。任务列表和脚注尚未启用,只列写法。参考:https://github.com/marp-team/marp-core/tree/v4#marp-markdown
表格与删除线属于 GFM 扩展,Marp Core 默认启用;高亮与上下标由 markdown-it-mark / sup / sub 提供,分别生成 mark / sup / sub。高亮使用现有文字选区的淡强调色,保留正文文字色;上下标沿用原生排版,复杂表达式仍使用数学公式。表中数字仅用于展示对齐。参考:https://github.github.com/gfm/#tables-extension- 、https://github.com/markdown-it/markdown-it-mark 、https://github.com/markdown-it/markdown-it-sup 和 https://github.com/markdown-it/markdown-it-sub
数学语法属于 Markdown 扩展,Marp Core 内置支持。本例通过 math: mathjax 选择 MathJax,也可选择 katex;不在浏览器重复加载网站公式组件。参考:https://github.com/marp-team/marp-core/tree/v4#math-typesetting
本页摘取 pseudocode.js 官方快速排序示例中的 Quicksort 过程,Partition 的完整写法见网站的 Cinderfolio-Pseudocode 页面。省略 math 选项时跟随文稿的 math: mathjax,也可用 math=katex 显式覆盖;默认显示行号、隐藏结束行、显示缩进竖线。算法字号与行距独立于 Marp 正文和 compact 设置,源码与渲染结果保持一致。官方示例来源:https://saswat.padhi.me/pseudocode.js/ The MIT License (MIT) Copyright (c) 2020-2023 Saswat Padhi (saswat.sourav@gmail.com) Copyright (c) 2015-2019 Tate Tian (tatetian@gmail.com) Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
mermaid 围栏在标准代码围栏上增加图表渲染,由 Cinderfolio 的 Pele 扩展在构建期生成 SVG,不属于当前 Marp Core 4.4.0 原生图表能力。每图使用独立 SVG ID,浏览器只接收生成结果。
IMPORTANT 采用 2px 强调色边框和现有淡强调底色,默认省略重复标题;NOTE 使用灰阶边界与浅层底色。正文、粗体与斜体继承所在段落的文字颜色。标注块可用于整页结论,也可直接放入 cf-col;解析由 Cinderfolio 的引擎扩展提供,样式随 cf-marp.css 导出。
五种标记共用强调色系与灰阶,通过标题和边框区分职责;普通 > 保留引用样式。引擎在构建期将 GitHub 风格的标注块转换为 HTML。参考:https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts
这两类扩展暂未接入,仅在代码围栏中介绍写法。当前 - [x] 保留为普通列表文字,[^note] 不会生成脚注。脚注扩展还需明确按页归属,而不是统一追加到文档末尾。来源:https://github.github.com/gfm/#task-list-items-extension- 及 https://github.com/markdown-it/markdown-it-footnote
本章介绍 Marp 原生的文档与单页指令、翻页转场、scoped 样式、图片尺寸与背景,以及分步列表和演讲备注。cover / compact / transition 的类名属于 Cinderfolio 主题,承载它们的 class 指令属于 Marp;transition 转场指令则控制翻页动画。参考:https://marpit.marp.app/markdown
theme / size 是全局指令。header / footer / paginate 是可继承的局部指令,放在文档开头作为全篇默认值,后续章节可再次更新;加下划线则只覆盖当前页。transition: fade 300ms 为整份 HTML 演示设置 300 毫秒淡入淡出,作用于当前页到下一页的边界;_transition: none 可单独关闭一处,PDF 不保留动画。转场由 CLI 的 bespoke 播放器提供,不影响 Cinderfolio 的 transition 章节页排版。header 支持 Markdown 链接,当前章节的加粗标记由 Cinderfolio 主题显示为选中的分块。链接使用实际幻灯片序号,封面跳过编号不会改变链接目标。size 可改为 4:3;独立一行的 --- 分页。参考:https://marpit.marp.app/directives 及 https://github.com/marp-team/marp-cli/blob/main/docs/bespoke-transitions/README.md
左侧为可复制的封面配置:作者、单位、日期保留为独立段落,副标题与信息项均可省略。文档已设置 paginate: true 时,封面使用 skip 后,下一张正文从 1 开始;false 只隐藏编号,仍消耗一个页码。class 是 Marp 原生指令,cover 是 Cinderfolio 提供的预设。参考:https://marpit.marp.app/directives
scoped 是 Marp 原生的单页样式。左例调整当前页代码字号,保留原生横向缩放;右例针对 Pele 生成的 Mermaid SVG 设置宽度,height: auto 保持原始比例,max-width: 100% 继续防止横向溢出。两段示例也可合并到同一个 style scoped 中。
完整背景图使用 ,fit 完整显示,cover 填满。图片按原始比例缩放,主题只限制最大宽度,不设置全局高度上限;作者需控制一页内图片的合计高度。两个示例照片的作者、许可和来源见 assets/SOURCE.json。参考:https://marpit.marp.app/image-syntax
这是本页实际备注:先逐项显示左栏,再逐项显示右栏;右栏使用英文半角右括号 1),不是全角 1)。cf-col 内的列表保留分步行为,整栏当前没有独立分步标记。分步交互需要播放器,静态 PDF 展示全部内容;普通注释成为演讲备注,Marp 指令注释由配置系统处理。独立横线 --- 用于分页,而不是在正文中显示 hr。参考:https://marpit.marp.app/fragmented-list 和 https://marpit.marp.app/usage?id=presenter-notes