📊 Advanced Slides 教程

用 Markdown 创建精美演示

从 Obsidian 到 Web 的完整工作流

作者: Claude Code | 日期: 2025-12-09

🤔 什么是 Advanced Slides?

Advanced Slides 是 Obsidian 插件:

  • 📝 用 Markdown 写演示文稿
  • 🎨 使用 Reveal.js 渲染
  • 🌐 发布到 Web
  • 💻 支持代码高亮

优势: 笔记即演示,演示即笔记!


📐 基础结构

Frontmatter 配置

---
title: "我的演示"
theme: "night"
transition: "slide"
controls: true
progress: true
slideNumber: true
---

配置演示文稿的外观和行为

幻灯片分隔

水平分隔 ---

<section>
内容1
</section>

---

<section>
内容2
</section>

垂直分隔(嵌套)

<section>
  <section>
    父幻灯片
  </section>

  <section>
    子幻灯片
  </section>
</section>

基本内容

<section>

## 标题

段落文本

- 列表项 1
- 列表项 2

</section>

支持所有标准 Markdown 语法!


🎨 主题选择

11 种内置主题

可用主题

**night** ⭐ 深色专业
**black** 经典黑色
**white** 简洁白色
**league** 蓝灰商务
**beige** 暖色复古
**sky** 明亮蓝色
**serif** 优雅衬线
**simple** 极简主义
**solarized** 护眼配色
**blood** 红黑对比
**moon** 深蓝月光

主题切换

在 frontmatter 中更改:

theme: "sky"

当前主题: sky (明亮蓝色) ☀️

提示: 尝试不同主题,找到最适合的!


✨ 过渡动画

可用过渡

**slide** (滑动) 最常用
**fade** (淡入) 平滑优雅
**convex** (凸出) 3D 效果
**concave** (凹陷) 3D 内凹
**zoom** (缩放) 放大缩小
**none** (无) 瞬间切换

配置过渡

transition: "slide"
backgroundTransition: "fade"
  • transition - 幻灯片切换效果
  • backgroundTransition - 背景切换效果

🎭 Fragment 动画

渐进式内容展示

基础 Fragment

<div class="fragment">
第一段出现
</div>

<div class="fragment">
然后第二段
</div>

<div class="fragment">
最后第三段
</div>
👆 像这样!
👆 一步一步!
👆 显示内容!

Fragment 效果

淡入淡出

<div class="fragment fade-in">
淡入
</div>

<div class="fragment fade-out">
淡出
</div>

高亮

<div class="fragment highlight-red">
红色高亮
</div>

<div class="fragment highlight-blue">
蓝色高亮
</div>

📐 布局系统

双栏布局

<div class="two-columns">

<div>
左栏内容
</div>

<div>
右栏内容
</div>

</div>
📝 **左边** 完美对比
📊 **右边** 并列展示

三栏布局

<div class="three-columns">
  <div>第一栏</div>
  <div>第二栏</div>
  <div>第三栏</div>
</div>
**功能 1** 简洁
**功能 2** 强大
**功能 3** 灵活

网格布局

<div class="grid grid-2">
  <div class="card">卡片1</div>
  <div class="card">卡片2</div>
  <div class="card">卡片3</div>
  <div class="card">卡片4</div>
</div>
📝 写作
🎨 设计
💻 编码
📊 展示

🎨 样式化框

信息框类型

💡 **高亮信息框** 用于重要提示和关键信息
⚠️ **警告信息框** 用于注意事项和警告
✅ **成功信息框** 用于成功消息和正面反馈
❌ **错误信息框** 用于错误提示和问题说明

使用方法

<div class="highlight-box">
💡 重要信息
</div>

<div class="warning-box">
⚠️ 注意事项
</div>

<div class="success-box">
✅ 成功提示
</div>

<div class="error-box">
❌ 错误警告
</div>

💻 代码展示

JavaScript 代码

function greet(name) {
  console.log(`Hello, ${name}!`);
}

greet("World");
✨ 自动语法高亮!

Python 代码

def calculate_fibonacci(n):
    if n <= 1:
        return n
    return calculate_fibonacci(n-1) + calculate_fibonacci(n-2)

print(calculate_fibonacci(10))
支持多种编程语言!

代码高亮行

function processData(data) {
  // 这行会高亮
  const result = [];
  for (let item of data) {
    result.push(item * 2);
  }
  return result;
}
使用 `{行号}` 语法高亮特定行

🎤 演讲者备注

什么是演讲者备注?

观众看到的

  • 幻灯片内容
  • 视觉元素
  • 主要信息

演讲者看到的

  • 幻灯片内容
  • 私人备注
  • 下一张预览
  • 计时器

添加备注

<section>

## 公开内容

观众看到的内容

<aside class="notes">
这是私人备注
只有演讲者能看到
可以添加提示和要点
</aside>

</section>
**快捷键**: 按 S 打开演讲者视图

⌨️ 键盘快捷键

导航快捷键

下一张
上一张
Home 第一张
End 最后一张

功能快捷键

F 全屏模式
S 演讲者视图
Esc 缩略图概览
B / . 暂停/黑屏
? 显示帮助
Alt+Click 放大

💼 完整工作流

从创建到发布

步骤 1: 在 Obsidian 创建

  1. 📂 打开 slides/ 文件夹
  2. 📝 创建新的 .md 文件
  3. ⚙️ 添加 frontmatter 配置
  4. ✍️ 使用 Templater 快速填充

步骤 2: 编写内容

---
title: "我的演示"
theme: "night"
---

<section>

# 标题

内容

</section>

---

<section>

## 第二页

更多内容

</section>

步骤 3: 预览和调整

  1. 在 Obsidian 中预览(Advanced Slides 插件)
  2. 检查布局和动画
  3. 调整内容和样式
  4. 添加演讲者备注

步骤 4: 发布到 Web

自动同步

  • 保存文件
  • Git 自动提交
  • 网站自动部署

Web 访问

  • /slides 查看列表
  • 点击查看演示
  • 分享链接

✨ 最佳实践

内容设计

✅ 推荐

  • 每页一个要点
  • 使用 fragment 渐进
  • 视觉元素辅助
  • 保持简洁

⚠️ 避免

  • 内容过多
  • 字体过小
  • 颜色冲突
  • 缺乏层次

演示技巧

💡 专业建议

  1. 开场强有力 - 吸引注意力
  2. 结构清晰 - 逻辑流畅
  3. 视觉一致 - 统一风格
  4. 互动引导 - 提问思考
  5. 结尾有力 - 留下印象

技术准备

  1. 📱 测试不同设备
  2. 🌐 检查浏览器兼容性
  3. 🎤 准备演讲者备注
  4. 💾 本地备份演示文件
  5. 🔗 准备分享链接

📚 示例库

现有演示

Obsidian 集成
完整功能展示

查看

Dataview 演示
查询功能详解

查看

本演示
Advanced Slides 教程

[当前页面]

模板资源

在你的笔记库中:

  • 📝 template/slides/templater-template.md - 幻灯片模板
  • 📚 docs/obsidian-integration-examples.md - 完整文档
  • 🎯 示例演示文稿 - 参考学习

🔧 故障排除

常见问题

问题: 幻灯片不显示

解决:

  • 检查 section 标签
  • 验证 frontmatter
  • 确认主题名称

问题: 样式不正确

解决:

  • 检查 CSS 类名
  • 验证 HTML 标签
  • 查看浏览器控制台

调试技巧

🔍 调试步骤

  1. 简化内容 - 从最简单的幻灯片开始
  2. 逐步添加 - 一次添加一个功能
  3. 检查语法 - 确保 HTML/Markdown 正确
  4. 查看示例 - 参考现有演示
  5. 浏览器工具 - F12 查看错误

📖 学习资源

官方文档

社区资源

**Obsidian 论坛** 讨论和求助
**Discord 社区** 实时交流
**GitHub Issues** 问题反馈
**YouTube 教程** 视频学习
**示例模板** 参考借鉴
**博客文章** 经验分享

🚀 下一步行动

立即开始

  1. 📥 安装 Advanced Slides 插件
  2. 📝 使用模板创建第一个演示
  3. 🎨 尝试不同主题和布局
  4. 🌐 发布到 Web 并分享

提示: 从简单开始,逐步掌握高级功能!

进阶挑战

设计大师

创建统一视觉风格的演示套件

动画专家

掌握所有 fragment 和过渡效果

工作流优化

整合 Templater + Dataview + Slides


🎉 感谢观看!

用 Markdown 创造精彩演示

✅ 简单易用的 Markdown 语法
✅ 强大灵活的 Reveal.js 功能
✅ Obsidian 完美集成
✅ 一键发布到 Web


📚 完整文档: `/docs/obsidian-integration-examples`

🎓 更多演示: /slides

💡 开始创建你的第一个演示吧!