做PPT这事儿我估计很多人都被折磨过内容写好了排版调半天排版调好了换个电脑字体全乱字体调好了又要导出PDF发给别人看结果页边距又不对。后来我干脆把整个创作流程改了——用Markdown写幻灯片再转成PDF。而最近这段时间我一直在用DeepSeek来辅助整条链路从写出幻灯片内容到排查转换报错再到批量处理文件确实省了不少力。这篇文章就把这套工作流完整分享一下包括方案怎么选、工具怎么配、踩过哪些坑以及DeepSeek在哪些环节真正帮上了忙。所有操作我都实测过适合正在被幻灯片折磨、又想用更轻量的方式做演示文稿的人。1. 为什么要把Markdown幻灯片转成PDF1.1 用Markdown写幻灯片到底图什么很多人一听“用Markdown写幻灯片”第一反应是这不是自找麻烦吗PowerPoint拖拽不好吗我最初也是这么想的直到有次做技术分享我发现自己大部分时间都花在调整文本框位置、对齐图片、修改列表缩进这些事上而真正该打磨的内容——逻辑、例子、数据——反而没时间管。Markdown写幻灯片的好处就在于内容即代码打开一个纯文本文件就是全部页面不存在的排版问题不需要操心字体大小、颜色深浅、边框粗细。你只需要专注把一页一页的内容写好剩下的呈现交给模板和主题。另一个现实需求是版本管理和协作。用PPT文件做协作每次改动都要传文件、合并内容麻烦得要命。Markdown文件是纯文本扔到Git里随便diff谁改了什么内容一目了然。我有个朋友在团队里推广了这套做法之后说终于不用在微信里传来传去“最终版PPT”了。再者Markdown幻灯片天然适合技术类内容的输出。代码块、表格、公式、图片引用这些在传统PPT里都挺费劲的但用Markdown写就是几行语法的事。比如你要在幻灯片里贴一段代码Markdown里直接写代码块就行渲染时自动带上语法高亮比手动截图好看得多。1.2 转PDF的常见路线对比写好了Markdown幻灯片文件下一步是把它变成PDF。市面上主流的路线有这么几条我挨个试过优缺点很明显路线工具优点缺点适合场景浏览器打印任意Markdown编辑器打开HTML浏览器打印为PDF简单、零依赖分页割裂频率高样式不好控制快速查看Marp CLIMarp的官方命令行工具基于Chromium无头模式专为幻灯片设计分页准确样式丰富需要安装Node.js环境正经的幻灯片导出Pandoc LaTeXPandoc配合LaTeX引擎排版质量最高公式效果好学习成本高安装体积大论文/书籍排版Pandoc wkhtmltopdfPandoc配合wkhtmltopdf适合从HTML生成PDF对有Web开发经验的人友好中文字体容易出问题Web风格文档我个人的结论很明确做幻灯片转PDF优先选Marp理由有三个第一Marp的生态就是围绕Markdown幻灯片设计的你在Markdown里写完分页、布局信息它能准确渲染成真实的分页幻灯片第二它支持自定义主题CSS页面的观感可控第三命令行工具非常成熟能嵌入自动化流程后面批量处理全靠它。1.3 DeepSeek在这套流程里扮演什么角色有人可能会问既然Marp CLI这么成熟一条命令就能转换那DeepSeek的“辅助”体现在哪这是个好问题。实际用下来DeepSeek并不是直接帮你执行转换命令那活儿交给Marp干而是在这几个环节深度参与帮你快速生成幻灯片内容的Markdown源码尤其是你不熟悉的领域先让AI给一个框架当你遇到Marp的语法报错、样式问题、中文字体乱码时把报错信息丢给它它能直接给出排查方向帮你写批处理脚本、调整自动化流程省得自己去查半天文档如果你不知道某个Markdown语法怎么写直接问它比自己翻文档快得多所以准确地说DeepSeek在这里是“工作流副驾”——写内容、排问题、补知识它都能搭把手。但最终的转换动作还是落在Marp这类工具上。这也符合我对AI工具的一贯看法让它做“编外顾问”和“代码手”而不是把自己的核心流程完全交给它否则出了问题都不知道从哪开始排查。2. 环境准备与核心工具选型2.1 DeepSeek的接入方式怎么选DeepSeek的接入方式有好几种我根据自己的使用习惯分成了三个路径Web端对话最省事的办法浏览器打开直接用适合日常问问题、写内容。不需要任何配置小白也能上手。VSCode插件接入如果你平时写Markdown用的是VSCode那直接在编辑器里接入DeepSeek会很爽。比如装一个Continue插件或者目前社区里很热的Codex、Cline类插件把API Key配好就能一边写Markdown一边让AI补全、修改内容不用来回切换窗口。API调用适合有自动化需求的场景比如你想写个脚本批量处理一大批幻灯片那可以把DeepSeek的API集成进去。官方接口是OpenAI兼容的调用成本很低也容易写代码。我日常用得最多的是Web端因为大部分内容生成和问题排查对话界面足够用。但如果你打算做批量处理那还是建议走API让整个流程无人值守跑起来。注意接入VSCode插件时注意看插件要求的Base URL和API Key格式不同插件配置方式略有差异。市面上的插件名称变化很快配置方法最好以官方文档为准。2.2 Markdown编辑器的选择标准在Windows机器上折腾一段时间之后我觉得Markdown编辑器不用太复杂关键看三点预览速度够不够快写幻灯片内容时你希望看到即时的渲染效果而不是改一下就要等好几秒才刷新。能否一键导出或预览成幻灯片模式Marp有个特点它的Markdown有特殊的语法分隔符---来分页。好的编辑器能让你直接用幻灯片模式预览。是否方便插入本地图片写技术分享的时候截图是免不了的。编辑器最好支持粘贴图片自动保存到本地文件夹省得手动保存再引用路径。按这个标准我推荐VSCode Markdown Preview Enhanced插件 Marp插件或者Typora。前者免费、插件生态强后者颜值高、写起来舒服。VSCode里装了Marp插件之后可以直接用幻灯片模式预览还能点击右上角按钮导出PDF非常省心。2.3 Marp CLI安装与基础配置如果要走命令行批量转换Marp CLI是绕不开的。安装很简单前提是你机器上有Node.js环境# 全局安装 marp-cli npm install -g marp-team/marp-cli # 验证安装 marp --version安装完之后基本的转PDF命令是marp slides.md --pdf --allow-local-files这里有个细节值得说一下--allow-local-files这个参数我第一次用的时候没加结果markdown里引用的本地图片全都没合并到PDF里页面上一片空白。原因在于Marp CLI默认出于安全考虑不允许读取本地文件系统你需要显式放行。这是命令行工具常见的安全设计——默认最小权限你用到哪就开哪。如果你的markdown里引用了远程URL的图片那不加--allow-local-files也能显示但本地图片就必须要这个参数。当初我就是没理解这一点差点以为图片路径写错了浪费了不少时间排查。3. 实操过程一次完整的转换全流程3.1 让DeepSeek先给你一个幻灯片骨架假设你要做一份“DevOps入门分享”的幻灯片传统写法是打开PPT新建页面逐页填内容。现在Marp的方式是直接用Markdown打字。但很多人一开始会卡在“怎么写”上这时候DeepSeek就是个好帮手。提示词很简单我一般这样写你是一位资深DevOps工程师要做一个面向研发团队的“DevOps入门”分享时长30分钟。 请用Markdown格式输出幻灯片内容每页之间用 --- 分隔。 要求第一页是标题页第二页写演讲者介绍和目录中间内容页控制在12页左右每页一条主线多用列表而不是大段文字。然后DeepSeek会直接给出一份完整的Marp格式源码每页的分隔符都帮你放好了。你拿到之后只需要再做两件事改成本次分享的真实信息、调整自己喜欢的内容顺序。这里分享一个技巧想让AI写出的内容“有技术味”你最好在提示词里附上一些竞品术语、框架名、关键词——比如“Kubernetes”“CI/CD”“基础设施即代码”。AI会顺着这些词汇去生成更贴近真实工作的内容而不是泛泛而谈。3.2 Marp幻灯片Markdown的基本语法与结构用Marp写幻灯片本质上就是在Markdown文件里加几个特殊语法。最核心的就是通过---分页符来分割页面--- marp: true theme: default --- # 第一页标题 这里是正文内容 --- # 第二页要点 - 第一个要点 - 第二个要点文件开头的marp: true是Marp的开关告诉解析器这个Markdown文件要用幻灯片的规则来渲染theme则指定主题Marp内置了default、gaia、uncover等主题你也可以写自定义CSS文件。常见的Marp高级语法还包括_class: lead让某页居中backgroundImage给页面设置背景图header/footer给每页统一加页眉页脚数学公式用$...$或$$...$$渲染LaTeX风格的公式代码高亮标准的Markdown代码块自动带语法高亮我在实际使用中最常用到的是分页符和类声明。比如我在做技术分享时习惯给小节起始页设置_class: lead让标题居中更醒目。再比如给每页统一加上公司Logo页眉用header字段就好。3.3 样式调整与主题选择Marp默认主题虽然干净但看多了还是会觉得千篇一律。想做出“有设计感”的PPT感有两个方向方向一用内置主题 CSS变量微调Marp的default主题支持自定义CSS变量比如改标题颜色、背景色、字体大小。一个最简单的做法就是在文件前面的front-matter里写CSS--- marp: true theme: default style: | section { background-color: #fafafa; font-size: 28px; } h1 { color: #2c3e50; } ---注意这里的style: |语法后面可以写多行CSS代码。我个人测试下来想要一整套符合审美的视觉建议好好利用这个入口微调标题颜色、正文字号、背景色基本就能达到“不至于太丑”的底线。方向二自定义外部主题CSS如果你要做的品牌物料比较多可以单独做一个theme.css文件然后在front-matter里引用--- marp: true theme: custom ---同时命令行运行时指定主题目录marp slides.md --pdf --theme ./theme.css --allow-local-files自定义主题的好处是一旦做好了团队里所有人引用同一个CSS产出的幻灯片风格统一省掉了很多沟通成本。这也是我发现Marp适合团队协作的一个重要原因——设计规范可以直接写成CSS代码。3.4 执行转换与成品检查在文件就绪后我一般先预览一遍再执行转换。VS Code里装了Marp插件后可以直接预览效果确认所有页面都没有问题后再用命令行导出marp slides.md --pdf --allow-local-files命令执行完同目录下会生成slides.pdf。拿到PDF后我通常会做这么几件事逐页翻一遍确认分页正确没有把一页的内容截断到下一页检查图片所有图片都正常显示没有丢失或者拉伸变形检查中文字体中文字符没有变成方块或乱码查看页脚页码如果设了footer确认没有遮挡正文这一步虽然简单但千万别偷懒。格式问题在屏幕上预览时不一定看得出来导出成PDF后反而容易暴露。我遇到过最典型的情况是在预览模式里看着排版很好的一页PDF里因为字体宽度不同导致文字溢出页面这种情况靠肉眼抽查才能发现。4. 常见问题与排查技巧实录4.1 怎么把“报错现场”交给DeepSeek分析用命令行工具遇到报错是司空见惯的事。我见过不少人一看到屏幕上的红色报错就慌了到处截图问人。其实条条大路通罗马与其满世界问人不如直接把报错信息交给DeepSeek。接下来说说正确姿势。DeepSeek不是神奇读心术你问“我转PDF失败了为什么”它只能给一堆泛泛的原因。你需要提供几个关键信息操作系统和Node.js版本完整的报错信息复制那几行红色大字别省略你的操作命令如果有必要贴一下你的markdown文件的关键部分我一般的提问格式是我在Windows 11上用Marp CLI把markdown转pdf运行 marp slides.md --pdf --allow-local-files 报错 [ERROR] ... [具体报错信息] 我的文件开头是 --- marp: true theme: default --- ... 请帮我分析原因并给出解决方法这样提问准确率很高。DeepSeek会结合报错信息去推断是语法问题、依赖问题还是版本兼容问题。我遇到过一次报错说Cannot find module xxx问了DeepSeek才知道是npm全局安装时依赖没装全解决办法是用npx重新执行或者重装依赖。4.2 中文乱码与特殊字体问题如果生成的PDF里中文全部变成了方框、黑块或者问号有一个最常见的原因系统缺少对应中文字体或者渲染引擎找不到字体。Marp CLI底层用的是无头Chromium渲染时会根据CSS指定的字体列表去系统里找字体。如果你没有在CSS里指定中文字体Chromium可能选了英文字体来渲染中文结果自然出错。解决办法分两步确认系统里安装了中文字体。Windows上一般有“微软雅黑”“SimHei”等macOS上有“苹方”“华文黑体”。在Marp的CSS里显式指定中文字体比如section { font-family: Microsoft YaHei, PingFang SC, Noto Sans CJK SC, sans-serif; }字体列表的写法是把系统里最想用的字体放最前面后面跟一些备选最后加一个sans-serif做兜底。这样渲染引擎就知道优先用哪个字体渲染中文一旦找不到还可以按顺序挑下一个。注意部分Linux服务器上默认没有中文字体这会让批量转PDF时中文全乱码。解决办法是手动安装字体包比如在Debian/Ubuntu系统上执行apt install fonts-noto-cjk然后把Noto Sans CJK SC加到字体列表里。4.3 图片丢失与路径问题图片不显示是我在实际使用中遇到频率第二高的问题。除了前面提到的--allow-local-files参数之外还有一个隐藏的坑是相对路径的计算基准。当你用VS Code的Marp插件预览时它会把当前打开的markdown文件所在目录作为基准所以能正常显示。但如果你换到命令行去执行marp slides.md --pdf有时候相对路径处理逻辑并不一样——尤其是当你在别的目录下执行命令时怪事更明显。最稳妥的做法把图片放在与markdown同级或者一个相对固定的目录命令在markdown所在目录下执行。比如cd /path/to/slides marp slides.md --pdf --allow-local-files如果图片实在多、路径极其复杂还有一招是直接把图片转成base64格式嵌入markdown但这会让文件变得很庞大上传和编辑都不方便非不得已不建议用。4.4 页边距、分页错乱这类版面问题有些同学转出来的PDF会发现某页内容被硬生生截成了两半或者页边距特别大文字挤在中间一小块。这类问题多半跟主题的CSS有关尤其是不小心引入了带打印样式的网页CSS。Marp的默认主题本来就是为了169的幻灯片设计的转PDF默认尺寸也是169。但也有一种情况就是你拿了一个普通网页的CSS用style指令塞进去了结果页面里多了很多padding、margin导致内容区域变窄排版自然乱。我的排查技巧是先把自定义style清零全部恢复默认转一次PDF看是不是正常。如果正常就说明是自己的CSS出了问题逐条加回来排查。如果还不正常那就要考虑是不是Marp版本更新导致语法变化去查一下官方文档。4.5 DeepSeek帮你写批量处理脚本人总有懒的时候。如果一次要做十几份幻灯片的PDF一条条敲命令确实浪费时间。这种场景我就直接让DeepSeek帮我写批处理脚本。我的需求描述一般是这样的我有一批 .md 文件放在 D:slides 目录下它们都是Marp格式的幻灯片。 请写一个Windows批处理脚本遍历这个目录下所有 .md 文件 用 marp CLI 把它们都转成 pdf 输出到 D:output 目录失败时打印错误信息。DeepSeek会返回一个完整的为Windows环境设计的批处理脚本通常是for循环遍历目录逐条执行marp命令判断errorlevel。如果我想在Linux/macOS上跑就让AI适配一下改成bash版本。这里要提醒一句AI生成的脚本尤其是涉及文件路径的建议先在两三个文件上小范围测试确认没有误操作后再全量跑。我就干过让AI写脚本、没检查就直接全量执行结果把源文件覆盖的事儿好在有备份。5. DeepSeek辅助的实际工作流体验5.1 一个人怎么管好“提示词→内容→成品”的链路我用这套工作流一段时间之后总结出一条可以稳定复制的链路需求拆解描述分享主题、目标听众、时长让DeepSeek产出第一版内容大纲分页生成把大纲浓缩成Marp格式每页一条主旨适配幻灯片的信息密度本地修改在VSCode里打开逐页微调补充真实案例和数据预览检查用Marp插件预览确认排版和图片路径命令行转换执行marp --pdf命令生成最终PDF人工终检翻开PDF逐页看有没有遗漏这套流程的快慢主要取决于你对Markdown和Marp语法是否熟悉。语法熟了一天的活轻松压缩到两三个小时。不熟也没关系DeepSeek就是你随叫随到的语法顾问不懂就问问完就写。5.2 几个我私藏的DeepSeek提示词分享几个实际用下来效果不错的提示词模板都是可以直接复制使用的生成内容骨架你是一位资深[行业]从业者请为一个面向[角色]的主题分享[主题]制作Marp幻灯片。 每页之间用 --- 分隔总共[数量]页避免大段文字尽量用短句和列表。排查报错我在执行[命令]时遇到以下报错 [粘贴报错信息] 我的环境是[操作系统]/[软件版本]。 这个报错可能是什么原因请给出具体排查步骤和解决办法。优化样式帮我把这个幻灯片调整成简洁商务风格标题用深蓝色正文用深灰背景浅灰白。 给我可以放到Marp front-matter里的 markdown 代码。批量处理帮我写一个 [Windows/Linux/macOS] 脚本来批量处理以下任务 遍历 [目录] 下所有 .md 文件执行 [命令]输出到 [目录] 跳过已经存在的PDF文件失败时日志写到 [文件]。用这些模板把具体内容替换进去填好你自己的实际需求DeepSeek给出的结果一般都能直接使用。5.3 要避免的坑对AI输出全盘照收用DeepSeek辅助有一个大前提核心内容你得自己审核。AI生成的技术分享大纲结构清晰但对一些细节可能理解不透比如行业内部的行话、你们团队的某个特定流程。所以我的习惯是只把AI当成一个快速起稿工具真正到“成型”阶段一定要人工过滤一遍。另外AI生成的markdown偶尔也会不合预期。比如前阵子它给我输出的一段front-matter里用了theme: custom.css实际Marp要求的是theme: custom并在命令行引用路径。这种案例说明它输出的语法只能作为参考遇到转换报错还得靠文档核对。5.4 这个工作流还能往哪些方向延伸做完了“Markdown转PDF”其实这套流程还有不少变体和进阶玩法多格式输出Marp CLI不仅能转PDF还能转PPTX、HTML一次编写多处产出自定义模板库把自己常用的布局、色彩、字体整理成CSS模板后续套用幻灯片批量生成当你有一堆相似结构的页面时用Python脚本生成Markdown配合DeepSeek辅助填充内容集成到发布流程在CI中执行marp命令每次内容更新后自动产出PDF/PPTX省掉手工导出我个人下一步的计划是想把这套流程再往前推一步用DeepSeek直接根据一个主题批量生成对应的markdown幻灯片然后接到CI里让整个“从想法到PPT”的过程更加自动化。当前已经能实现“半自动”人工还是在内容审核环节起到了决定性的作用。在生产环境里一步步实践之后我的感受是工具链再优秀也不能替代人的判断。Markdown让内容回归文本DeepSeek让输出效率翻倍Marp让呈现变得体面。三者结合起来我几乎不再为幻灯片排版发愁可以把更多精力放到内容本身。你也试着做一次打开VSCode装好插件让DeepSeek帮你起个头然后Run一下转换命令。第一次被分页符---惊艳到的时候你会回来感谢这套流程的。