aipmandy/liveppt

**Turn Markdown/README into clickable, page-turnable, shareable HTML demo pages. **

Chinese Simplified

---

What is LivePPT?

LivePPT is not a traditional PPT tool, nor is it just a simple README template.

It’s more like a “demo page generator”:

• Enter Markdown content / README
• Generate HTML with a single command
• Results can be opened, flipped through pages, presented, and shared directly

In short: **First turn content into results, then gradually upgrade to a more advanced presentation experience. **

Why use it

🌐 Online Experience

• Project official website / online demo (available after enabling Warehouse Pages)
• Actual demo source code
• Automated regression testing

The homepage is located in the repository root directory index.html, so no Node.js is required to build. For initial deployment, refer to the GitHub Pages configuration steps.

Get started quickly in 30 seconds

Shortest path: Ready README directly generates HTML

Then open it directly:

If you don’t have any content, use another command to generate HTML

Current Core Competencies

• build-from-readme:README directly generates HTML deck
• build-showcase: One command generates Markdown content + HTML
• render_plan_to_html.py: Renders Markdown as a single-file HTML deck
• add_theme.py: Generates the theme token CSS
• Supports parameters for theme, brand name, and cover subtitle
• Supports page turning, navigation points, progress bar, and keyboard control

Suitable Scenarios

• Open source project release: turning the README / changelog into a demo page
• Product Launch: Quickly create explanation-ready and shareable web presentations
• B-end pre-sale: the same content can be cut into different visual styles
• Course handouts: break down knowledge content into rhythmic pages

Project Structure

Current Boundaries

The current version can already solve the following:

• Markdown / README directly outputs HTML
• Quickly obtain a demonstratable and shareable result
• Switch between different thematic styles within the same content

The issue is not yet fully resolved:

• Any README lossless high-fidelity relay press conference page
• Automatic recognition of complex layouts
• One-click export of complete static site resource packages
• A more granular page template system