欢迎使用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.mdPDF大纲功能支持两种生成方式按页面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 ChromeMicrosoft EdgeMozilla 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?familyNotoSansSCdisplayswap); section { font-family: Noto Sans SC, sans-serif; } /style # 中文标题示例 正常显示中文字体❓ 图片路径如何处理对于相对路径的图片Marp CLI会自动处理。但如果你需要引用绝对路径或网络图片建议使用base64编码或确保图片可访问本地图片  !-- Base64编码的小图片 -- 内嵌图片❓ 如何添加演讲者视图Marp CLI支持演讲者视图可以在浏览器中同时显示当前幻灯片和下一张幻灯片# 启动演讲者视图 marp --server --preview slide-deck.md访问http://localhost:8080后按P键可以切换到演讲者视图模式。社区资源与扩展指南 深入学习资源Marp CLI基于Marpit框架构建如果你需要更高级的定制功能可以学习Marpit框架了解底层的幻灯片渲染引擎查看源码结构项目源码位于src/目录包含完整的类型定义研究插件系统在src/engine/目录中查看各种插件实现 扩展开发建议如果你需要扩展Marp CLI的功能建议从以下几个方面入手自定义转换器参考src/converter.ts实现新的输出格式主题开发基于现有的主题文件创建新的视觉风格插件开发利用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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
