scientific-skills/markdown-mermaid-writing/templates/presentation.md
Back to Markdown Style Guide — Read the style guide first for formatting, citation, and emoji rules.
Use this template for: Slide-deck-style documents, research presentations, briefings, lectures, walkthroughs, or any content that would traditionally be a PowerPoint. Designed to read well as a standalone document AND to serve as speaker-ready presentation notes.
Key features: Collapsible speaker notes under every section, structured flow from context through content to action items, figure captions, and footnote citations.
[bracketed placeholders] with your contentThe presentation follows a 6-section flow. Each section has an H2 with one emoji, content, and optional collapsible speaker notes.
1. 🏠 Housekeeping — Logistics, context, announcements
2. 📍 Agenda — What we'll cover, with time estimates
3. 🎯 Objectives — What the audience will walk away with
4. 📚 Content — The main body (multiple H3 topics)
5. ✍️ Action Items — What happens next, who owns what
6. 🔗 References — Citations, resources, further reading
Everything below the line is the template. Copy from here:
[Context line — project, team, date, or purpose]
Total: [estimated time]
<details> <summary><strong>💬 Speaker Notes</strong></summary>After this presentation, you'll be able to:
[Opening context — why this matters, what problem it solves]
Key points:
Image placeholder: images/slide-[filename].png
Figure 1: [What this image demonstrates]
<details> <summary><strong>💬 Speaker Notes</strong></summary>💡 Key insight: [The one-liner the audience should remember from this topic]
[Context and explanation]
Comparison of approaches:
| Approach | Best for | Tradeoffs |
|---|---|---|
| [Option A] | [Scenario] | [Pro/con] |
| [Option B] | [Scenario] | [Pro/con] |
| [Option C] | [Scenario] | [Pro/con] |
flowchart LR
accTitle: [Short title for this diagram]
accDescr: [One sentence describing what the diagram shows]
step1[⚙️ Step one] --> step2[🔍 Step two] --> step3[✅ Step three]
[Explanation of what the diagram shows and why it matters]
<details> <summary><strong>💬 Speaker Notes</strong></summary>Option A:
Option B:
[Context and explanation]
Process:
⚠️ Common pitfall: [What goes wrong and how to avoid it]
[Deeper explanation, examples, or data supporting the topic]
<details> <summary><strong>💬 Speaker Notes</strong></summary>| Action | Owner | Due |
|---|---|---|
| [Specific action item] | [Person/team] | [Date] |
| [Specific action item] | [Person/team] | [Date] |
| [Specific action item] | [Person/team] | [Date] |
All footnote references from the presentation are collected here:
Last updated: [Date]
[Author/Org]. ([Year]). "[Title]." [Publication]. https://example.com ↩