# Marp-Autosplitter | fast PPT generator

Marper 是一个快速、智能的命令行工具，能将任意 Markdown 文档完美转换为排版精美、高度精准的 PPTX 和 PDF 演示文稿。它通过自动切分内容并修复跨页结构，再利用 Marp 转为适合展示的 PPTX 和 PDF 演示文稿。程序确保每一页都美观且信息完整，无论是文本、表格还是 LaTeX 公式，都能得到完美呈现。

Marper is a simple, fast, intelligent, and standalone tool designed to flawlessly convert any Markdown document into beautifully formatted, highly precise PPTX and PDF presentations. Powered by a physical-level measurement engine, it automatically paginates lengthy content and smartly repairs cross-page structures. Leveraging Marp under the hood, it ensures every slide is rendered perfectly. (English documentation down below)

• Marp

• 零依赖即开即用：无需安装 Python、Node.js 或任何繁琐环境，下载双击即可运行。
• 物理级精准防溢出：真实渲染高度测量，杜绝内容越界。
• 语义感知分页：支持根据指定的标题层级（如文档中存在的前 2 级标题）自动智能断页。
• 细胞级结构保护：跨页时自动修补 Markdown 表格（补全表头）与列表结构，确保 LaTeX 公式完美渲染。
• 高度可定制：内置多款主题，并支持挂载本地 themes 文件夹拓展自定义 CSS 皮肤。
• 跨平台免配置：自动探测系统内置的 Chrome/Edge 浏览器，支持 Windows, macOS, Linux。
• 可视化操作界面：内置现代化 Web UI，支持文件拖拽、参数可视化调节，一键输出结果。

前往本仓库的 Releases page 页面。

根据你的操作系统下载对应的可执行文件（如 Marp-Windows.exe）。如为压缩包(tar.gz)，请解压后进入文件夹找到可执行文件。

双击运行该程序。一个现代化的 Web 控制台将自动在你的浏览器中打开，上传 Markdown 文档即可一键生成排版完美的 PPTX 和 PDF！

我们还提供了一个在线版本的 Marper，支持直接在浏览器中使用，无需下载任何文件。访问以下链接即可体验： Marper on Huggingface 该在线版本性能受限于 Huggingface 的资源限制，适合小规模文档的快速测试和体验。对于大文档或频繁使用，建议下载本地版本以获得更好的性能和稳定性。

Marper 支持根据文档中的标题层级自动分页，保持内容逻辑连贯。 Marper supports automatic pagination based on heading levels in the document, maintaining logical coherence.

如果多层结构被分隔，Marper 会在下一页自动补全缺失的内容层级，保持内容逻辑完整。 If multi-level structures are split across pages, Marper automatically fills in the missing hierarchy on the next page to maintain logical coherence.

表格将会被自动分割并补全表头，确保跨页展示时信息完整。 Tables are automatically split and headers are filled in to ensure complete information across pages.

请确保你的电脑已安装 Python 3.10+ 和 Node.js。

1. 克隆并进入项目

git clone https://github.com/Hronrad/marper
cd marper

2. 安装核心依赖

npm install
pip install -r requirements.txt

(注：程序会自动调用本机的 Chrome/Edge，无需额外执行 playwright install)

基础转换（默认输出 PPTX 和 PDF，使用 default 主题）：

python cli.py report.md

带参数的进阶转换（使用 gaia 主题，文档中前 3 级标题都触发分页，输出 PPTX 和 HTML）：

python cli.py report.md -t gaia -l 3 -f pptx html

生成的中间件 .md 和最终的 PPT 文件均会自动保存在项目根目录下的 output_slides 文件夹中。

使用中如遇问题或有任何建议，欢迎提交 Issue 或 Pull Request！ 如果觉得本项目对你有帮助，别忘了点个 Star 支持一下！✨

• Zero Dependencies: No Python, no Node.js required. Just download and run.
• Physical-Level Overflow Prevention: Utilizes real headless browser DOM height measurements, guaranteeing zero content overflow or text truncation.
• Semantic Pagination: Intelligently breaks pages based on your document's heading structure, maintaining logical flow.
• Cell-Level Structure Protection: Automatically repairs Markdown tables (injecting missing headers) and nested lists across page breaks.
• Modern Web UI: Comes with a built-in, user-friendly web interface. Just drag and drop your files and click generate.

No coding experience required. Get your presentation in 3 simple steps:

1. Go to the Releases page of this repository.
2. Download the standalone executable for your operating system (e.g., Marp-Windows.exe). If it's a compressed file (like .tar.gz), simply extract it and find the executable inside the folder.
3. Double-click to run. A modern Web UI will automatically open in your default browser. Upload or simply paste your .md file content, tweak the settings, and instantly download your PPTX/PDF!

For quick testing without any downloads, you can also use our online version of Marper directly in your browser: Marper on Huggingface Please note that the online version is subject to Huggingface's resource limitations and is best suited for small documents or quick demos. For larger files or frequent use, we recommend downloading the offline client for better performance and stability.

If you want to modify the core engine or use the Command Line Interface (CLI) for batch processing, you can set up the development environment:

# 1. Clone the repository
git clone https://github.com/Hronrad/marper
cd marper

# 2. Install dev dependencies (Requires Python 3.10+ and Node.js)
npm install @marp-team/marp-cli
pip install -r requirements.txt

# 3. Run via CLI
python cli.py report.md -t gaia -l 3 -f pptx html

If you encounter any issues or have feature suggestions, feel free to open an Issue or submit a Pull Request! If this project helped improve your workflow, please consider leaving a ⭐️ Star!