mirror of
https://github.com/tiennm99/HugoBlox-kit.git
synced 2026-10-05 14:14:41 +00:00
George Cushen
aa9edea5df
- Add branding overlays: logo, title, author, and footer text - Use Reveal.js theme CSS variables for automatic color adaptation - Inline SVGs for currentColor support on any theme - Per-slide control via HTML comments: - <!-- no-branding -->: hide all elements - <!-- no-header -->: hide logo + title - <!-- no-footer -->: hide author + footer - Fix body-level CSS selectors for proper visibility - Add comprehensive documentation in example slides
Markdown Slides
The Presentation Framework for Researchers
Stop wrestling with PowerPoint.
Write slides in Markdown, version control your talks, and present code & math beautifully.
🚀 Deploy in 60s (Free) • Live Demo • Lore Studio (Visual Editor)
▶︎ Watch Preview
https://github.com/user-attachments/assets/5a93788a-65d7-4a56-8355-4a2098a5f89b
Why this template?
Traditional slide software (PowerPoint, Keynote) locks your content in binary files, breaks code formatting, and makes version control a nightmare.
- 📝 Markdown-first: Write slides like you write papers. Focus on content, not pixel-perfect alignment.
- ⚗️ Research-ready: Native support for LaTeX math (
E=mc^2), citations, and rich metadata (venue, DOI, authors). - 💻 Code-native: Beautiful syntax highlighting for 100+ languages without screenshots.
- 🎓 Deck Landing Pages: Every presentation gets a dedicated searchable landing page with abstract and download links.
- 🚀 Present Anywhere: Browser-based presenter mode (Reveal.js) with speaker notes, timer, and offline support.
Who it’s for
- Academics presenting at conferences (share a URL, not a USB drive).
- Data Scientists explaining complex analyses with real code snippets.
- Lecturers creating course materials that students can actually search, read, and fork.
- Developers who prefer their IDE over a GUI presentation tool.
What you get (Free)
- Professional Presenter Mode: Speaker notes, timer, and next-slide preview.
- Rich Metadata: Associate events, co-authors, and related links with each deck.
- PDF Export: One-click printable version for handouts.
- Mermaid Diagrams: Draw flowcharts and sequence diagrams in text.
- Theming: Light, dark, and custom themes included.
- Mobile Optimized: Responsive gallery and slide viewer.
Get started (recommended)
Option 1 — Online deployer (fastest)
Deploy this template in ~60 seconds:
Option 2 — Lore Studio (visual editor in VS Code)
Option 3 — HugoBlox CLI (developer workflow)
Install:
npm install -g hugoblox@latest
Create a site:
hugoblox create site --template markdown-slides
Customize in 10 minutes
- Create a deck:
content/slides/my-talk/index.md - Slide syntax: Use
---to separate slides. - Speaker notes: Use
Note:at the end of a slide. - Theme: Set
slides.theme: black(or white, league, night, etc.) in frontmatter. - Site Identity:
config/_default/params.yaml
Want the Pro version? 💎
If you want a version that feels meaningfully more premium (and helps fund open source + research):
Community & support
- Docs: docs.hugoblox.com →
- Discord: Join Discord →
- Issues: Open an issue →
MIT © 2016–Present George Cushen