宽版 / 
窄版阅读宽度切换
- 
原始 Markdown 视图
+- 内置 Slides 演示模式（`---` 分页、键盘翻页、全屏演示）
- 
内容复制（Markdown / 文本 / HTML）
- 
服务重启并保留会话
- 自动会话备份与恢复
@@ -124,6 +125,42 @@ $ markview --unwatch '/Users/you/project/**/*.md' # 按绝对路径
| ------------------------------------------------------- | ------------------------------------------------------- |
|  |  |
+### 内置 Slides 演示模式
+
+在文档右侧工具列点击 `Slides` 按钮即可进入演示模式。
+
+- 使用 `---` 分隔幻灯片（代码块内的 `---` 不会被当作分页）
+- 每次只渲染当前页，适合现场讲解
+- 支持全屏演示与快捷键导航
+
+示例：
+
+```md
+# 封面
+
+这是第一页
+
+---
+
+# 第二页
+
+这是第二页
+```
+
+常用操作：
+
+| 操作 | 快捷键 / 交互 |
+| --------------------- | --------------------------------------------------------- |
+| 下一页 | `→` / `PageDown` / `Space` / `Enter` / 点击幻灯片空白区域 |
+| 上一页 | `←` / `PageUp` |
+| 首/末页 | `Home` / `End` |
+| 切换全屏 | `F` |
+| 退出 | `Esc`（全屏时优先退出全屏，再次按下退出 Slides） |
+| 固定/取消固定演示控件 | `H` |
+
+> [!TIP]
+> 全屏状态下，演示控件会在短暂无操作后自动隐藏；移动鼠标、触控或按键会再次显示。
+
### 启动与停止
`markview` 默认后台运行，命令会立即返回，不阻塞当前终端。
@@ -250,6 +287,29 @@ $ markview --status --json
$ make build
```
+## 可选：Markdown PPT 导出（Marp）
+
+如果你需要导出离线讲稿（PDF/PPTX），仓库提供了 `docs/slides/` 的 Marp 模板与主题，可通过 Makefile 预览和导出：
+
+```console
+$ make slides-preview
+$ make slides-pdf
+$ make slides-pptx
+```
+
+默认使用：
+
+- `docs/slides/tech-talk-template.md`
+- `docs/slides/theme-markview.css`
+
+你也可以覆盖输入文件（示例）：
+
+```console
+$ make slides-pdf SLIDES_FILE=docs/slides/my-talk.md
+```
+
+更多模板说明见：`docs/slides/README.md`
+
## 中文文档
为了便于本地阅读和二次开发，仓库提供了以下中文文档：
diff --git a/docs/markdown-capabilities.md b/docs/markdown-capabilities.md
index aef3513..d4e8565 100644
--- a/docs/markdown-capabilities.md
+++ b/docs/markdown-capabilities.md
@@ -63,6 +63,11 @@
- ToC 面板（按 H1-H6 标题导航）
- 当前标题高亮与平滑滚动定位
- 原文视图（Raw）与渲染视图切换
+- Slides 演示视图（按 `---` 分页，代码块内分隔线自动忽略）
+ - 支持按钮翻页与键盘翻页（`←/→`、`PageUp/PageDown`、`Space/Enter`、`Home/End`）
+ - 支持 `F` 全屏、`Esc` 退出（全屏时优先退出全屏）
+ - 支持点击幻灯片空白区域下一页
+ - 全屏下支持演示控件自动隐藏与 `H` 固定/取消固定
- 全局全文搜索后可跳转到目标文档并定位命中内容
## 4. 结构化关系能力
diff --git a/docs/quick-start-visual.md b/docs/quick-start-visual.md
index d612935..a9dad96 100644
--- a/docs/quick-start-visual.md
+++ b/docs/quick-start-visual.md
@@ -35,6 +35,16 @@ $ markview -p 16275 -b localhost --no-open testdata/basic.md testdata/mermaid-fl
- 图表块支持缩放/全屏等交互（不同图表能力略有差异）
- 目录、原文、复制、导出等按钮在文档右侧工具列
+### 2.1 快速体验内置演示模式（Slides）
+
+在任意 Markdown 文档右侧点击 `Slides` 按钮即可进入演示模式：
+
+- 使用 `---` 进行分页（代码块内 `---` 不会触发分页）
+- `F` 切换全屏，`Esc` 退出（全屏时先退全屏）
+- 可用 `←/→`、`Space`、`PageUp/PageDown` 翻页
+- 点击幻灯片空白区域也可进入下一页
+- 全屏下控件会自动隐藏；`H` 可固定/取消固定控件
+
## 3) 体验结构可视化模式
在页面顶部工具栏点击图谱相关按钮：
diff --git a/docs/slides/README.md b/docs/slides/README.md
new file mode 100644
index 0000000..d815735
--- /dev/null
+++ b/docs/slides/README.md
@@ -0,0 +1,39 @@
+# Markdown PPT（Marp）模板
+
+本目录提供一套可直接开讲的 Marp 幻灯片模板。
+
+## 文件说明
+
+- `tech-talk-template.md`：演示模板（16:9、分页、结构化内容）
+- `theme-markview.css`：深色中文主题
+
+## 本地预览
+
+在仓库根目录执行：
+
+make slides-preview
+
+## 导出 PDF
+
+make slides-pdf
+
+## 导出 PPTX
+
+make slides-pptx
+
+## 自定义输入文件
+
+make slides-preview SLIDES_FILE=docs/slides/my-talk.md
+make slides-pdf SLIDES_FILE=docs/slides/my-talk.md SLIDES_PDF=docs/slides/my-talk.pdf
+make slides-pptx SLIDES_FILE=docs/slides/my-talk.md SLIDES_PPTX=docs/slides/my-talk.pptx
+
+## 不走 Makefile（可选）
+
+pnpm dlx @marp-team/marp-cli docs/slides/tech-talk-template.md --theme-set docs/slides/theme-markview.css --preview
+
+## 快速改造建议
+
+1. 先改标题页与目录页
+2. 每页只放一个核心观点
+3. 一页最多 5~7 条要点
+4. 代码页只展示最关键片段
diff --git a/docs/slides/tech-talk-template.md b/docs/slides/tech-talk-template.md
new file mode 100644
index 0000000..b66c62d
--- /dev/null
+++ b/docs/slides/tech-talk-template.md
@@ -0,0 +1,112 @@
+---
+marp: true
+theme: markview
+paginate: true
+size: 16:9
+footer: 'markview · 技术分享模板'
+---
+
+
+
+# 标题：你的主题
+
+### 副标题（可选）
+
+**演讲者**：你的名字
+**日期**：2026-05-11
+
+---
+
+## 今天你将听到什么
+
+1. 背景与问题
+2. 核心方案
+3. 关键实现
+4. 实验结果
+5. 下一步计划
+
+---
+
+## 背景与问题
+
+- 现状：一句话描述当前场景
+- 痛点：列 2~3 个关键问题
+- 目标：明确可衡量目标（如耗时、成功率、体验）
+
+> 建议：每页只讲一个主观点。
+
+---
+
+## 方案总览
+
+- 方案 A：最小可行，先跑通
+- 方案 B：工程化增强，降低长期成本
+- 取舍：开发速度 vs 维护复杂度
+
+| 方案 | 开发成本 | 维护成本 | 推荐 |
+| ---- | -------- | -------- | --------- |
+| A | 低 | 中 | ✅ |
+| B | 中 | 低 | ✅（迭代） |
+
+---
+
+## 关键实现（代码示例）
+
+```ts
+interface BuildOptions {
+ platform: string;
+ arch: string;
+}
+
+export function resolveRuntimeKey(opts: BuildOptions): string {
+ return `${opts.platform}-${opts.arch}`;
+}
+```
+
+- 把复杂逻辑封装成可测试函数
+- 优先让失败可观测（日志/错误信息）
+
+---
+
+## 效果对比
+
+- 改造前：偶发失败、跨设备不稳定
+- 改造后：自动自愈、重复执行稳定
+
+**关键收益**
+
+- 交付稳定性提升
+- 切机/换架构成本下降
+- 团队协作摩擦减少
+
+---
+
+## 风险与边界
+
+- 边界 1：网络异常导致依赖下载失败
+- 边界 2：锁文件版本漂移
+- 边界 3：本地缓存污染
+
+**应对策略**
+
+- 明确重试与回滚策略
+- 固定关键版本
+- 保留一键修复入口
+
+---
+
+## 下一步计划
+
+- [ ] 增加 CI 校验
+- [ ] 补齐回归测试
+- [ ] 增加文档与操作手册
+
+Tip：最后一页最好给出明确的行动项。
+
+---
+
+
+
+# Q & A
+
+谢谢大家 🙌
diff --git a/docs/slides/tech-talk-template.pdf b/docs/slides/tech-talk-template.pdf
new file mode 100644
index 0000000..5b1b51c
Binary files /dev/null and b/docs/slides/tech-talk-template.pdf differ
diff --git a/docs/slides/theme-markview.css b/docs/slides/theme-markview.css
new file mode 100644
index 0000000..641f1fc
--- /dev/null
+++ b/docs/slides/theme-markview.css
@@ -0,0 +1,132 @@
+/* @theme markview */
+@import 'default';
+
+:root {
+ --mv-bg: #0f172a;
+ --mv-bg-soft: #1e293b;
+ --mv-fg: #e2e8f0;
+ --mv-muted: #94a3b8;
+ --mv-accent: #38bdf8;
+ --mv-accent-2: #a78bfa;
+ --mv-border: #334155;
+ --mv-code-bg: #111827;
+}
+
+section {
+ background: linear-gradient(160deg, var(--mv-bg) 0%, #111827 60%, #0b1020 100%);
+ color: var(--mv-fg);
+ font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", "Noto Sans CJK SC", sans-serif;
+ padding: 56px 64px;
+ font-size: 32px;
+ line-height: 1.45;
+}
+
+section.lead {
+ justify-content: center;
+}
+
+h1,
+h2,
+h3 {
+ margin: 0 0 0.45em 0;
+ line-height: 1.2;
+ letter-spacing: 0.01em;
+}
+
+h1 {
+ color: #f8fafc;
+ font-size: 1.6em;
+}
+
+h2 {
+ color: #e2e8f0;
+ font-size: 1.25em;
+}
+
+h3 {
+ color: #cbd5e1;
+ font-size: 1.05em;
+}
+
+p,
+li {
+ color: var(--mv-fg);
+}
+
+strong {
+ color: #f8fafc;
+}
+
+a {
+ color: var(--mv-accent);
+}
+
+ul,
+ol {
+ margin-top: 0.35em;
+}
+
+li {
+ margin: 0.25em 0;
+}
+
+blockquote {
+ border-left: 4px solid var(--mv-accent-2);
+ background: rgba(148, 163, 184, 0.08);
+ color: #dbeafe;
+ padding: 0.6em 0.9em;
+ border-radius: 8px;
+}
+
+code {
+ background: rgba(148, 163, 184, 0.14);
+ border: 1px solid rgba(148, 163, 184, 0.2);
+ border-radius: 6px;
+ padding: 0.08em 0.32em;
+ font-family: "SFMono-Regular", Menlo, Monaco, Consolas, "Liberation Mono", monospace;
+ font-size: 0.85em;
+}
+
+pre {
+ margin: 0.6em 0;
+ border-radius: 10px;
+ border: 1px solid var(--mv-border);
+ background: var(--mv-code-bg);
+}
+
+pre code {
+ border: 0;
+ background: transparent;
+ padding: 0;
+ font-size: 0.78em;
+}
+
+table {
+ border-collapse: collapse;
+ width: 100%;
+ font-size: 0.75em;
+}
+
+th,
+td {
+ border: 1px solid var(--mv-border);
+ padding: 0.45em 0.55em;
+}
+
+th {
+ background: rgba(56, 189, 248, 0.15);
+}
+
+small {
+ color: var(--mv-muted);
+}
+
+footer {
+ color: var(--mv-muted);
+ font-size: 0.42em;
+}
+
+section::after {
+ color: rgba(148, 163, 184, 0.8);
+ font-size: 0.45em;
+}
\ No newline at end of file
diff --git a/frontend/scripts/pnpm-install-safe.sh b/frontend/scripts/pnpm-install-safe.sh
new file mode 100644
index 0000000..303a6fa
--- /dev/null
+++ b/frontend/scripts/pnpm-install-safe.sh
@@ -0,0 +1,24 @@
+#!/usr/bin/env sh
+
+set -eu
+
+STAMP_FILE="node_modules/.markview-node-arch"
+CURRENT_ARCH="$(pnpm node -p "process.platform + '-' + process.arch")"
+
+if [ -d "node_modules" ]; then
+ if [ ! -f "$STAMP_FILE" ]; then
+ echo "markview: node_modules 缺少架构标记，执行一次清理重装 ($CURRENT_ARCH)"
+ rm -rf node_modules
+ else
+ PREV_ARCH="$(cat "$STAMP_FILE" 2>/dev/null || true)"
+ if [ "$PREV_ARCH" != "$CURRENT_ARCH" ]; then
+ echo "markview: 检测到架构切换: $PREV_ARCH -> $CURRENT_ARCH，清理 node_modules 后重装"
+ rm -rf node_modules
+ fi
+ fi
+fi
+
+pnpm install
+
+mkdir -p "$(dirname "$STAMP_FILE")"
+printf "%s\n" "$CURRENT_ARCH" > "$STAMP_FILE"
diff --git a/frontend/src/components/MarkdownViewer.slides.test.tsx b/frontend/src/components/MarkdownViewer.slides.test.tsx
new file mode 100644
index 0000000..d4efb90
--- /dev/null
+++ b/frontend/src/components/MarkdownViewer.slides.test.tsx
@@ -0,0 +1,254 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { fireEvent, render, screen, waitFor } from "@testing-library/react";
+import userEvent from "@testing-library/user-event";
+import { MarkdownViewer } from "./MarkdownViewer";
+import { fetchFileContent, openRelativeFile } from "../hooks/useApi";
+
+vi.mock("../hooks/useApi", () => ({
+ fetchFileContent: vi.fn(),
+ openRelativeFile: vi.fn(),
+}));
+
+vi.mock("./TocToggle", () => ({
+ TocToggle: () => null,
+}));
+
+vi.mock("./RawToggle", () => ({
+ RawToggle: () => null,
+}));
+
+vi.mock("./CopyButton", () => ({
+ CopyButton: () => null,
+}));
+
+vi.mock("./PdfExportButton", () => ({
+ PdfExportButton: () => null,
+}));
+
+vi.mock("./RemoveButton", () => ({
+ RemoveButton: () => null,
+}));
+
+vi.mock("./BacklinksPanel", () => ({
+ BacklinksPanel: () => null,
+}));
+
+describe("MarkdownViewer slides mode", () => {
+ let requestFullscreenMock: ReturnType
)}
+ {isSlidesView && (
+ setIsRawView((v) => !v)} />
+ { }} />);
+ expect(screen.getByTitle("Show slides")).toBeInTheDocument();
+ });
+
+ it("shows 'Exit slides' title when open", () => {
+ render( { }} />);
+ expect(screen.getByTitle("Exit slides")).toBeInTheDocument();
+ });
+
+ it("has aria-pressed false when closed", () => {
+ render( { }} />);
+ const button = screen.getByRole("button", { name: "Slides" });
+ expect(button).toHaveAttribute("aria-pressed", "false");
+ });
+
+ it("has aria-pressed true when open", () => {
+ render( { }} />);
+ const button = screen.getByRole("button", { name: "Slides" });
+ expect(button).toHaveAttribute("aria-pressed", "true");
+ });
+
+ it("calls onToggle when clicked", async () => {
+ const user = userEvent.setup();
+ const onToggle = vi.fn();
+ render(
+
+ PPT 模式 · 第 {currentSlideLabel}/{Math.max(slides.length, 1)} 页 · 快捷键 F 全屏
+
+
+ )}
{renderedContent}
-
+
+
+
+