欢迎使用Marp CLI

欢迎使用Marp CLI

【免费下载链接】marp-cliA CLI interface for Marp and Marpit based converters项目地址: https://gitcode.com/gh_mirrors/ma/marp-cli

第二页幻灯片

• 列表项1
• 列表项2
• 列表项3

代码演示

def hello_world(): print("Hello from Marp CLI!")

使用`---`分隔符创建新的幻灯片页面，这是Marp的核心语法之一。 ## 核心功能深度解析 ### 🔄 实时预览与服务器模式 Marp CLI的服务器模式让你在修改Markdown文件时能够实时看到幻灯片效果变化： ```bash # 启动本地服务器预览 marp --server slide-deck.md # 指定端口和目录 marp --server --port 3000 ./slides/

启动后，访问http://localhost:8080即可在浏览器中查看幻灯片。每次保存Markdown文件，页面都会自动刷新显示最新内容。

服务器模式特别适合演讲排练和内容调整，你可以一边修改幻灯片内容，一边在浏览器中查看实际效果。

📄 高级PDF导出功能

Marp CLI的PDF导出功能提供了丰富的定制选项，满足不同场景的需求：

# 生成带大纲的PDF marp --pdf --pdf-outlines slide-deck.md -o presentation.pdf # 包含演讲者备注 marp --pdf --pdf-notes slide-deck.md -o presentation-with-notes.pdf # 设置页面尺寸和边距 marp --pdf --pdf-size A4 --pdf-margin 20mm slide-deck.md

PDF大纲功能支持两种生成方式：按页面（pdf-outlines.pages）或按标题层级（pdf-outlines.headings），这让你可以创建结构清晰的文档导航。

演讲者备注功能让你可以在Markdown中使用HTML注释添加内部笔记：

# 公开幻灯片内容 <!-- 这是演讲者备注：详细介绍技术背景 -->

这些备注不会显示在公开的幻灯片上，但可以导出到PDF中供演讲者参考。

💼 PowerPoint兼容性

对于需要与使用Microsoft Office的同事协作的场景，Marp CLI提供了PPTX导出功能：

# 导出为PowerPoint格式 marp --pptx slide-deck.md -o presentation.pptx # 批量转换多个文件 marp --pptx *.md -o presentations/

导出的PPTX文件完全兼容Microsoft PowerPoint，保留了所有格式和布局，包括：

• 幻灯片标题和内容层级
• 列表和代码块格式
• 图片和表格布局
• 基本的动画效果

这个功能特别适合企业环境，你可以在Markdown中快速创建内容，然后导出为标准的PowerPoint文件进行分发和演示。

高级技巧与最佳实践

🎨 自定义主题与样式

Marp CLI支持自定义主题，让你创建符合品牌风格的幻灯片：

# 使用单个自定义主题 marp --theme custom-theme.css slide-deck.md # 使用主题集合 marp --theme-set ./themes/ slide-deck.md

主题文件使用标准的CSS语法，你可以从项目中的src/engine/transition/keyframes/目录找到各种过渡效果的SCSS文件作为参考。例如，创建一个简单的主题文件：

/* custom-theme.css */ :root { --primary-color: #2563eb; --secondary-color: #64748b; } section { background: linear-gradient(135deg, #f8fafc, #e2e8f0); color: #1e293b; } h1 { color: var(--primary-color); border-bottom: 3px solid var(--secondary-color); } code { background-color: #f1f5f9; border-radius: 4px; padding: 2px 6px; }

🌈 丰富的过渡效果

Marp CLI内置了多种幻灯片过渡效果，类似于PowerPoint的动画效果。你可以在Markdown中使用transition指令指定过渡效果：

--- transition: cube --- # 使用立方体过渡效果 --- <!-- 下一页会自动继承过渡效果 --> ## 平滑的页面切换

项目提供了超过20种内置过渡效果，包括：

• fade：淡入淡出
• slide：滑动效果
• cube：立方体旋转
• flip：翻转效果
• zoom：缩放过渡

你可以在src/engine/transition/keyframes/目录中找到所有过渡效果的实现，每个效果都有对应的SCSS文件定义动画关键帧。

🔧 批量处理与自动化

对于需要处理多个幻灯片的场景，Marp CLI支持批量操作：

# 批量转换所有Markdown文件 marp --pdf *.md # 递归处理子目录 marp --pptx **/*.md -o presentations/ # 使用配置文件 marp --config marp.config.js slide-deck.md

创建配置文件marp.config.js可以保存常用设置：

module.exports = { // 输出设置 output: 'dist', // 主题设置 themeSet: './themes', // PDF设置 pdf: true, pdfOutlines: true, // 图片质量 images: 'png', jpegQuality: 90 }

常见问题与解决方案

❓ 如何解决浏览器依赖问题？

Marp CLI在转换PDF、PPTX和图片时需要浏览器引擎支持。如果遇到错误，请确保系统中安装了以下浏览器之一：

• Google Chrome
• Microsoft Edge
• Mozilla Firefox

如果你不想在本地安装浏览器，可以使用Docker容器：

docker run --rm -v $PWD:/home/marp/app marpteam/marp-cli slide-deck.md --pdf

❓ 中文字体显示异常怎么办？

在Markdown文件中指定中文字体可以解决字体显示问题：

--- theme: default --- <style> @import url('https://fonts.googleapis.com/css2?family=Noto+Sans+SC&display=swap'); section { font-family: 'Noto Sans SC', sans-serif; } </style> # 中文标题示例 正常显示中文字体

❓ 图片路径如何处理？

对于相对路径的图片，Marp CLI会自动处理。但如果你需要引用绝对路径或网络图片，建议使用base64编码或确保图片可访问：

本地图片 ![网络图片](https://example.com/image.jpg) <!-- Base64编码的小图片 --> 内嵌图片

❓ 如何添加演讲者视图？

Marp CLI支持演讲者视图，可以在浏览器中同时显示当前幻灯片和下一张幻灯片：

# 启动演讲者视图 marp --server --preview slide-deck.md

访问http://localhost:8080后，按P键可以切换到演讲者视图模式。

社区资源与扩展指南

📚 深入学习资源

Marp CLI基于Marpit框架构建，如果你需要更高级的定制功能，可以：

1. 学习Marpit框架：了解底层的幻灯片渲染引擎
2. 查看源码结构：项目源码位于src/目录，包含完整的类型定义
3. 研究插件系统：在src/engine/目录中查看各种插件实现

🔌 扩展开发建议

如果你需要扩展Marp CLI的功能，建议从以下几个方面入手：

1. 自定义转换器：参考src/converter.ts实现新的输出格式
2. 主题开发：基于现有的主题文件创建新的视觉风格
3. 插件开发：利用Marpit的插件系统添加新功能

🛠️ 调试与故障排除

当遇到问题时，可以使用以下调试技巧：

# 启用详细日志 marp --verbose slide-deck.md # 检查配置加载 marp --config marp.config.js --help # 查看版本信息 marp --version

【免费下载链接】marp-cliA CLI interface for Marp and Marpit based converters项目地址: https://gitcode.com/gh_mirrors/ma/marp-cli