jdan/cleaver
Cleaver
Cleaver is a developer-focused presentation creator and static HTML presentation framework. It functions as a markdown slideshow generator that converts structured plain text into formatted HTML outputs for browser display.
The tool enables rapid slide deck iteration through a live-reloading workflow that monitors source files for changes. It supports custom presentation styling by injecting external CSS, applying visual themes, and allowing per-slide formatting overrides.
The system includes capabilities for automated slide compilation, including the generation of author credits and metadata configuration. It provides a user interface with keyboard navigation and configurable on-screen elements, while offering template overrides to modify the structure of individual slides.
Features
- Markdown-to-HTML Slide Converters - Converts Markdown source files into HTML slideshows specifically formatted for browser viewing.
- Slide Parsing - Parses a single Markdown file into individual slides using specific character delimiters.
- Markdown to HTML Converters - Transforms structured Markdown documents into formatted HTML output for browser display.
- HTML Templates - Injects parsed Markdown content into predefined HTML shells to maintain consistent layout across slides.
- Hot Reload Triggers - Monitors source files for changes to automatically trigger recompilation and refresh the presentation.
- Plain-Text Presentation Tools - Designed for technical users who prefer plain-text content authoring and CSS-based style management.
- Rapid Iteration Workflows - Enables rapid iteration through a live-reloading workflow that provides immediate visual feedback on content changes.
- Source File Watching - Implements a watch mode that monitors source files to automate real-time presentation recompilation.
- Style Injections - Supports the injection of external CSS stylesheets and local files to override default visual themes.
- HTML Presentation Frameworks - Provides a framework for creating web-based slideshows customizable via external CSS, JS, and templates.
- Markdown Presentation Generation - Generates complete presentation decks from Markdown source, including the full pipeline from text to styled HTML.
- Presentation Styling Utilities - Provides utilities for applying custom CSS and HTML templates to define the visual layout of slides.
- Documentation Metadata Configurations - Sets document names and author details through configuration to generate final information slides.
- Custom Style Injection - Provides the ability to apply external or local CSS stylesheets to customize the visual appearance of generated presentations.
- Layout Template Overrides - Allows the replacement of default slide templates with custom structural definitions to modify layout.
- Slide-Level Class Overrides - Allows assigning custom CSS classes to individual slides for unique formatting and layout overrides.
- Automatic Meta-Slide Generation - Automatically compiles structured text into a final presentation including generated author credit slides.
- Credit Slide Generation - Creates a dedicated slide at the end of the presentation using identity and contact details.
- Metadata-Driven Rendering - Uses configuration metadata and frontmatter to automatically generate credit slides and document properties.
- Visual Themes - Supports loading stylesheets, scripts, and templates from local or remote sources to define the overall visual identity of the deck.
