综合介绍
Moffee 是一个开源工具,它能把 Markdown 文件快速变成专业的幻灯片,简单又高效。用户只需写好 Markdown 内容,Moffee 就能自动处理布局、分页和样式,省去手动排版的麻烦。它支持实时预览,用户可以边写边看效果,还能导出成 HTML 或 PDF 文件。Moffee 用 Python 开发,最低需要 Python 3.10 环境。它的设计目标是让幻灯片制作更轻松,适合需要快速生成演示文稿的人使用。
提示大模型你要使用 Moffee 语法生成markdown格式文档,并重复强调声明,生成的markdown格式文档用于生成 Moffee语法的PPT幻灯片。这就是所有AIPPT类产品基本原理。再次提起此产品的原因是最近有一群搞流量的非要把文档用Claude转换为PPT。
功能列表
- 将 Markdown 文件一键转换为幻灯片,支持自动分页和标题选择。
- 提供实时预览功能,边编辑 Markdown 边查看幻灯片效果。
- 支持多种主题,如 default、beam、robo、blue、gaia,方便切换样式。
- 允许自定义布局和 CSS 样式,比如调整背景颜色或字体。
- 使用分隔符(如
---
、===
、<->
)灵活排列文本和图片。 - 支持导出幻灯片为 HTML 或 PDF 文件,方便分享或演示。
- 内置数学公式(如
)和代码块渲染,适合技术演示。
使用帮助
安装流程
Moffee 需要在 Python 环境里运行,下面是详细的安装步骤:
- 检查 Python 版本
打开终端,输入python --version
或python3 --version
,确认版本是 3.10 或更高。如果低于这个版本,需要先升级 Python。 - 创建虚拟环境(可选但推荐)
在终端输入以下命令创建一个干净的环境:
conda create -n moffee_py310 python=3.10
conda activate moffee_py310
或者用 Python 自带的 venv:
python3 -m venv moffee_env
source moffee_env/bin/activate # Mac/Linux
moffee_env\Scripts\activate # Windows
- 安装 Moffee
激活环境后,输入以下命令安装:
pip install moffee
安装完成后,可以用 moffee --version
检查是否成功。
- 准备 Markdown 文件
新建一个.md
文件,比如example.md
,写入内容。可以用任意文本编辑器,比如 VS Code 或 Notepad。
如何使用
Moffee 提供两种主要使用方式:实时预览和导出文件。
实时预览功能
- 在终端进入 Markdown 文件所在的文件夹。
用cd
命令切换目录,比如:
cd /path/to/your/folder
- 启动本地服务。
输入以下命令:
moffee live example.md
启动后,Moffee 会在本地运行一个网页服务器,默认地址是 http://127.0.0.1:5500/
。
- 打开浏览器查看。
在浏览器输入http://127.0.0.1:5500/
,就能看到幻灯片效果。编辑 Markdown 文件时,页面会自动更新。
导出幻灯片
- 如果不需要实时预览,可以直接导出。
输入命令:
moffee make example.md -o output_html/
这会生成一个 output_html
文件夹,里面包含幻灯片的 HTML 文件。
- 查看导出结果。
打开output_html
文件夹里的index.html
,用浏览器查看幻灯片。也可以用工具把 HTML 转为 PDF。
特色功能操作
- 编写 Markdown 文件
Moffee 支持简单的 Markdown 语法。比如:
# 标题
这是一段文字。
- 列表项1
- 列表项2
这些会被自动转为幻灯片页面。
- 页面分隔
用---
分隔不同页面:
第一页内容
----------
第二页内容
- 横向排列
用<->
把文字和图片放同一行:
文字 <-> 
- 纵向排列
用===
分隔上下内容:
上半部分
========
下半部分
- 自定义样式
在文件开头加 front matter 设置样式:
---
theme: blue
background-color: lightgray
---------------------------
# 内容
这样可以改主题或背景颜色。
- 数学公式和代码
直接写公式或代码,Moffee 会自动渲染:
公式:$E = mc^2$
代码:`print("Hello")`
操作流程示例
假设你要做一个技术分享幻灯片:
- 新建
tech.md
文件,写入:
---
theme: robo
aspect_ratio: "16:9"
--------------------
# 技术分享
今天聊聊 Moffee。
-----------------
## 功能
- 简单易用
- 实时预览
- 运行
moffee live tech.md
,打开浏览器看效果。 - 调整内容,满意后用
moffee make tech.md -o tech_slides/
导出。
应用场景
- 教学演示
老师可以用 Moffee 把课程笔记转为幻灯片,快速准备课堂内容。 - 技术分享
开发者可以用它整理技术文档,生成会议用的演示文件。 - 个人演讲
需要演讲的人可以用 Markdown 写稿子,马上转为专业幻灯片。
QA
- Moffee 支持哪些操作系统?
只要有 Python 3.10 以上版本,Windows、Mac、Linux 都能用。 - 怎么解决启动失败的问题?
检查 Python 版本是否正确,确保用pip install moffee
安装成功。如果还有问题,试试更新 pip:pip install --upgrade pip
。 - 可以离线使用吗?
可以。安装后不需要联网,直接用命令生成幻灯片。