web-presentation

Web-presentation is a Jekyll theme template that converts Markdown files into a chronological, navigable web presentation hosted on GitHub Pages.

What is web-presentation?

Web-presentation is a Jekyll theme template designed to quickly build a presentation as a web page. It takes Markdown files as input and produces a static website that displays those files as slides in chronological order. The project runs on GitHub Pages, which automatically generates and updates the website after each push (allow up to 1 minute). It is an open-source template that anyone can fork to create their own presentation with no additional setup.

Key Features

• Chronological slide order — Slides appear in the order of their filename dates, using a valid year-month-day format such as 1000-01-01-example.md.
• Horizontal year navigation — Years are displayed horizontally on the page, letting visitors jump between different years of content.
• Vertical month navigation — Within a selected year, months appear as vertical navigation to drill into specific months.
• GitHub Pages integration — Push changes to the repository and GitHub Pages rebuilds the presentation site automatically.
• Simple file-based workflow — Create a new slide by adding a Markdown file with the required date prefix; no HTML or configuration edits needed.
• Free and open source — The template is available for anyone to use, modify, and redistribute.

Who is it for?

Web-presentation suits developers and technical writers who are comfortable with Git and Markdown and want to maintain presentation content in a version-controlled repository. It also works well for conference speakers and educators who need a static, self-hosted slide deck without paying for presentation software. Teams already using GitHub Pages can adopt this template to publish meeting notes, project updates, or training material as a structured timeline.

What can you do with web-presentation?

• Conference speakers: Create a talk deck by writing one Markdown file per slide, pushing to GitHub, and sharing the auto-generated URL with the audience.
• Course instructors: Organize lecture notes by date so students can navigate the material month by month and year by year.
• Project managers: Publish a chronological project changelog or status report as a visual timeline without building a custom frontend.

How does web-presentation work?

Fork the repository, rename it, and edit or add Markdown files whose names begin with a valid date in year-month-day format. Commit and push to GitHub; GitHub Pages automatically regenerates the site, typically within a minute. The template then renders the files as a single-page presentation with horizontal year navigation and vertical month navigation.