md2slide

name

md2slide

description

从论文、arXiv 预印本或技术文档生成模块化 Beamer 学术幻灯片，面向非专家（本科生级别）听众。 使用 Comic Sans MS + HarmonyOS Sans 字体，采用 content/*.tex 模块化项目结构。 支持联网补充素材，当用户提供的内容不完整时自动搜索补充。 四阶段流水线：素材整理+联网研究 → 大纲设计 → 模块化内容生成 → 编译输出 PDF。 Use when: (1) 用户想把论文/arXiv/技术文档转为演示幻灯片, (2) 用户提及 论文幻灯片, 学术汇报, 论文解读, paper reading, beamer slides, arXiv to slides, conference talk, (3) 用户有论文 PDF/TeX 想为同学/非专家听众制作幻灯片, (4) 用户想要 Comic Sans 或 HarmonyOS Sans 字体风格, (5) 用户想要 content/*.tex 模块化项目结构。

Beamer 学术幻灯片生成

将论文转化为模块化、高信息密度的 Beamer 幻灯片，面向非专家听众。

流水线

论文/素材 → 素材整理+联网补充 → outline.md → content/*.tex 模块化生成 → xelatex 编译 → output/slides.pdf

阶段 0：环境检查与输入定位

0.1 定位输入素材

按优先级搜索当前目录中的素材文件：

1. assets/ 目录（含论文源文件 .tex/.docx/.pdf 及补充材料）
2. 当前目录下的 .tex 文件
3. .docx Word 文档
4. .pdf 论文
5. arXiv 链接（由用户提供）

若找到多个候选文件，询问用户选择哪一个。 若未找到任何素材："请把论文文件放到当前目录（支持 .tex / .docx / .pdf），或提供 arXiv 链接"

0.2 检查 LaTeX 与字体

检查 xelatex 可用性：

which xelatex

若缺失，建议安装（与用户操作系统对应的标准 LaTeX 安装方式相同）。

检查字体可用性：

fc-list | grep -i "comic sans"
fc-list | grep -i "harmonyos"

字体策略：Comic Sans MS 和 HarmonyOS Sans SC 为首选字体。 若缺失，提供安装帮助或建议备选方案：

• 拉丁文字备选：Nunito（圆润风格，与 Comic Sans 视觉感受相近）
• 中文字体备选：Noto Sans CJK SC

若用户无 LaTeX 环境，交付 .tex + .sty + figure/ 文件并建议使用 Overleaf 在线编译。

0.3 配置

检查当前目录是否有 config.yaml。若缺失，询问用户：

• 演示文稿标题和副标题
• 作者姓名、单位、日期
• 配色方案：blue | red | green | purple | teal

阅读 references/tex-header.md 获取导言模板。

阶段 1：素材整理与研究

此阶段至关重要——用户提供的素材通常是不完整的。 需要主动识别知识缺口并通过联网搜索补充。

1.1 阅读与提取

阅读 assets/ 中所有文件，提取四个维度的信息：

1. 研究问题：这篇论文解决什么问题？为什么重要？
2. 方法：核心技术方案、架构、算法
3. 结果：关键实验、指标、对比
4. 个人见解：这项工作有何亮点？是否有历史类比？

从论文源文件中提取图片到 figure/ 目录：

• .tex 来源：定位 \includegraphics 路径，复制原始图片
• .pdf 来源：使用 pdfimages -all paper.pdf figure/ 或裁剪图片区域
• .docx 来源：提取嵌入图片

1.2 联网研究（必须执行）

系统性地识别已提取素材中的知识缺口，联网搜索补充：

• 论文假设听众已知但实际不知的背景知识
• 关键概念的解释（如"什么是 HPO 本体？"、"Function Call 与 MCP 的区别"）
• 最新统计数据或参考文献
• 作者/机构背景信息

将研究发现保存到 assets/Clippings/，附来源 URL。

1.3 整合素材

在项目根目录编写 materials.md，按主题组织，附来源标注：

## 1. 研究背景
罕见病影响全球约 3 亿患者... (来源: Rare Disease International)
...每条关键信息附带来源 URL...

1.4 图片清单

提取完成后，列出可用图片及其描述。按优先级排序：

• 论文中的图片（质量高，直接相关）
• 辅助理解的补充图表
• 系统架构 / 工作流图（方法页必备）

阶段 2：大纲设计

2.1 叙事结构

遵循四章节叙事弧线（可前置可选作者介绍页）： 0. 作者介绍（可选，1 页）：封面与目录之间，介绍论文作者/汇报人背景

1. 研究背景与摘要（1-2 页）：问题、先前工作、贡献预览
2. 方法与创新（5-7 页）：核心思路、架构、工作流
3. 实验与结果（3-4 页）：每页一个实验
4. 个人见解（1 页）：汇报者的收获

目标：15-18 页正文（不含封面和致谢），1 页可选作者介绍，2 页可选附录。

2.2 逐页规划

编写 outline.md，每页按以下结构规划：

### P3: 研究问题
- **核心信息**: 8000+ 种罕见疾病, 3 亿患者, 5-7 年诊断延迟
- **版式**: 左文右图
- **内容来源**: materials.md §1, 论文表 1
- **配图**: figure/challenge_overview.pdf

2.3 节奏约束

• 不允许连续 3 页使用相同布局
• 每章至少使用 2 种不同布局
• 文字密集页与图片密集页交替出现

阅读 references/layouts.md 了解可用布局类型，references/writing-style.md 了解组合模式。

阶段 3：内容生成

3.1 项目结构

按以下目录布局生成文件：

project/
├── assets/                  # 用户提供的参考素材
│   └── Clippings/           # 联网研究发现
├── figure/                  # 所有被 .tex 引用的图片
├── content/                 # 章节 .tex 文件，每节一个
├── output/                  # 编译产物 slides.pdf 及构建文件
├── materials.md             # 整合后的素材（附来源）
├── outline.md               # 逐页大纲
├── slides.tex               # 主文件，\input 各 content/*.tex
└── beamerthemeAcademic.sty  # 主题文件（从 assets/ 复制）

3.2 生成 slides.tex

主文件只包含导言和 \input 命令——不包含任何页面内容。 阅读 references/tex-header.md 获取导言模板。

% slides.tex — 主文件，负责导言和 \input
\documentclass[aspectratio=169, 12pt]{beamer}
\usepackage{beamerthemeAcademic}
\useblue
% ... 导言（详见 references/tex-header.md）...

\begin{document}

\input{content/01-cover}
% \input{content/00-author}  % 可选：作者介绍页（封面与目录之间）
\begin{frame}\frametitle{汇报提纲}\tableofcontents\end{frame}
\input{content/02-background}
\input{content/03-method}
\input{content/04-results}
\input{content/05-insights}
\input{content/06-thanks}
% \input{content/07-appendix}  % 可选

\end{document}

3.3 生成 content/*.tex

每章对应 content/ 中的一个文件。命名规范：

• 01-cover.tex — \begin{frame}[plain]\titlepage\end{frame}
• 00-author.tex — 作者介绍页（可选，使用 author-intro 布局，见 references/layouts.md）
• 02-background.tex — 研究问题与贡献
• 03-method.tex — 系统架构、工作流、关键组件
• 04-results.tex — 实验（每页一个，左文右图）
• 05-insights.tex — 个人收获
• 06-thanks.tex — \thanksframe{...}{...}（无需外层 \begin{frame}，命令已内置）
• 07-appendix.tex — 补充细节（可选）

每页从 references/layouts.md 加载对应的布局骨架。

3.4 排版规则

以下规则适用于每一页。这是承载性约束——必须精确遵循。

字号层级——每页只选一个正文字号，不要混用：

• \small — 低密度页面的正文
• \footnotesize — 中密度页面的正文
• \scriptsize — 高密度页面正文、表格、列表
• \tiny — 图注、附录、极紧凑内容

分栏布局——两栏总宽度不得超过 0.95\textwidth：

• 常用比例：0.40 + 0.55（左文右图），0.48 + 0.47（对称）

图片放置——统一格式，图片和图注用 \begin{center} 包裹以保证水平居中：

\begin{center}
  \includegraphics[width=\linewidth, height=0.55\textheight, keepaspectratio]{figure.pdf}

  \vskip0.05cm
  {\tiny\color{textgray}图 X: 图注说明}
\end{center}

• 图文混排页：图片高度 0.45--0.55\textheight
• 满版图片页：0.55\paperheight，图注放在同一个 \begin{center} 内
• 全文顺序编号（图 1, 图 2, ...）
• 在 columns 环境中，beamer 为每栏设置 \raggedright——必须将图片+图注一起用 \begin{center} 包裹，不要单独使用 {\centering...\par}

实验页——所有实验使用统一布局以保证视觉一致性：

左栏 0.40\textwidth (\scriptsize)    右栏 0.55\textwidth
  实验设计                              \begin{center}
  ↓                                     图片 (0.55\textheight)
  结果（表格或文字）                     \vskip0.05cm
  ↓                                     图注 (\tiny)
  分析（1-3 行）                       \end{center}

每个实验：设计 → 结果 → 分析，一页完成。

表格——紧凑风格，使用 booktabs：

• \begin{tabular}{@{}ll@{}} 配合 \toprule / \midrule / \bottomrule
• \scriptsize 或 \tiny，最多 8 行
• 宽表格使用显式列宽：p{2.0cm}

公式——每页最多 2 个：

• 使用 \scriptstyle 缩小行内公式：$\scriptstyle\mathcal{M}_1 = \{...\}$
• 配合解释性文字，面向非数学听众

间距——保持紧凑：

• \vskip 取值 0.02--0.15cm
• 大段落分隔：\vspace{0.1cm}
• 每帧不超过 3 个 \vskip（超过说明内容过多）

常用布局模式：

% 左文右图
\begin{columns}[T, onlytextwidth]
  \column{0.40\textwidth}  % 文字
  \column{0.55\textwidth}  % 图片
\end{columns}

% 上方图片，下方两栏
\begin{center}\includegraphics[...]{...}\end{center}
\begin{columns}[T, onlytextwidth]
  \column{0.48\textwidth}  \column{0.48\textwidth}
\end{columns}

% TikZ 高亮框
\begin{tikzpicture}
  \node[draw=accentcolor, rounded corners=5pt, fill=black!4,
        inner sep=6pt, text width=3.6cm, align=left] {...};
\end{tikzpicture}

% 分隔线
{\centering\color{lightline}\rule{0.6\linewidth}{0.3pt}\par}

阶段 4：编译与验证

4.1 编译

mkdir -p output
xelatex -output-directory=output -interaction=nonstopmode slides.tex
xelatex -output-directory=output -interaction=nonstopmode slides.tex

两遍编译以生成目录。也可使用 scripts/compile.sh。

4.2 版面问题检测

检查 output/slides.log 中的 overfull 警告：

grep "Overfull" output/slides.log

症状	修复方法
Overfull \vbox	减少文字、拆为 2 页或缩小字号
Overfull \hbox（含图片）	添加 keepaspectratio、减小 width
分栏溢出	确保栏宽之和 ≤ 0.95\textwidth
图片与文字重叠	减小图片高度或文字长度

容忍度：overfull ≤ 10pt 可接受，超过须修复。

4.3 交付

输出文件位于 output/slides.pdf。向用户展示页数，并提供针对特定页的迭代修改。

参考文件

• references/tex-header.md — Comic Sans MS + HarmonyOS Sans 导言模板
• references/layouts.md — 布局骨架（含 LaTeX 代码）
• references/writing-style.md — 面向非专家听众的写作指南

资源文件

• assets/beamerthemeAcademic.sty — Beamer 主题（复制到用户项目根目录）
• assets/config.yaml — 配置模板