企业官网建设流程全解析

做PPT这事儿，我估计很多人都被折磨过：内容写好了，排版调半天；排版调好了，换个电脑字体全乱；字体调好了，又要导出PDF发给别人看，结果页边距又不对。后来我干脆把整个创作流程改了——用Markdown写幻灯片，再转成PDF。而最近这段时间，我一直在用DeepSeek来辅助整条链路，从写出幻灯片内容，到排查转换报错，再到批量处理文件，确实省了不少力。这篇文章就把这套工作流完整分享一下，包括方案怎么选、工具怎么配、踩过哪些坑，以及DeepSeek在哪些环节真正帮上了忙。所有操作我都实测过，适合正在被幻灯片折磨、又想用更轻量的方式做演示文稿的人。

1. 为什么要把Markdown幻灯片转成PDF

1.1 用Markdown写幻灯片到底图什么

很多人一听“用Markdown写幻灯片”，第一反应是：这不是自找麻烦吗？PowerPoint拖拽不好吗？

我最初也是这么想的，直到有次做技术分享，我发现自己大部分时间都花在调整文本框位置、对齐图片、修改列表缩进这些事上，而真正该打磨的内容——逻辑、例子、数据——反而没时间管。Markdown写幻灯片的好处就在于：内容即代码，打开一个纯文本文件就是全部页面，不存在的排版问题，不需要操心字体大小、颜色深浅、边框粗细。你只需要专注把一页一页的内容写好，剩下的呈现交给模板和主题。

另一个现实需求是版本管理和协作。用PPT文件做协作，每次改动都要传文件、合并内容，麻烦得要命。Markdown文件是纯文本，扔到Git里随便diff，谁改了什么内容一目了然。我有个朋友在团队里推广了这套做法之后，说终于不用在微信里传来传去“最终版PPT”了。

再者，Markdown幻灯片天然适合技术类内容的输出。代码块、表格、公式、图片引用，这些在传统PPT里都挺费劲的，但用Markdown写就是几行语法的事。比如你要在幻灯片里贴一段代码，Markdown里直接写代码块就行，渲染时自动带上语法高亮，比手动截图好看得多。

1.2 转PDF的常见路线对比

写好了Markdown幻灯片文件，下一步是把它变成PDF。市面上主流的路线有这么几条，我挨个试过，优缺点很明显：

我个人的结论很明确：做幻灯片转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编辑器不用太复杂，关键看三点：

1. 预览速度够不够快：写幻灯片内容时，你希望看到即时的渲染效果，而不是改一下就要等好几秒才刷新。
2. 能否一键导出或预览成幻灯片模式：Marp有个特点，它的Markdown有特殊的语法分隔符（---）来分页。好的编辑器能让你直接用幻灯片模式预览。
3. 是否方便插入本地图片：写技术分享的时候，截图是免不了的。编辑器最好支持粘贴图片自动保存到本地文件夹，省得手动保存再引用路径。

按这个标准，我推荐：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后，我通常会做这么几件事：

1. 逐页翻一遍：确认分页正确，没有把一页的内容截断到下一页
2. 检查图片：所有图片都正常显示，没有丢失或者拉伸变形
3. 检查中文字体：中文字符没有变成方块或乱码
4. 查看页脚页码：如果设了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可能选了英文字体来渲染中文，结果自然出错。

解决办法分两步：

1. 确认系统里安装了中文字体。Windows上一般有“微软雅黑”“SimHei”等，macOS上有“苹方”“华文黑体”。
2. 在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文件所在目录作为基准，所以![图](./images/a.png)能正常显示。但如果你换到命令行去执行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的默认主题本来就是为了16：9的幻灯片设计的，转PDF默认尺寸也是16：9。但也有一种情况，就是你拿了一个普通网页的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 一个人怎么管好“提示词→内容→成品”的链路

我用这套工作流一段时间之后，总结出一条可以稳定复制的链路：

1. 需求拆解：描述分享主题、目标听众、时长，让DeepSeek产出第一版内容大纲
2. 分页生成：把大纲浓缩成Marp格式，每页一条主旨，适配幻灯片的信息密度
3. 本地修改：在VSCode里打开，逐页微调，补充真实案例和数据
4. 预览检查：用Marp插件预览，确认排版和图片路径
5. 命令行转换：执行marp --pdf命令，生成最终PDF
6. 人工终检：翻开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一下转换命令。第一次被分页符---惊艳到的时候，你会回来感谢这套流程的。