Create presentation slide decks as Markdown (.md) files for the Obsidian Advanced Slides plugin (reveal.js-based). Use this skill whenever the user wants to create slides, presentations, a slide deck, or diapositivas in Obsidian Markdown format, or mentions "obsidian-advanced-slides", "reveal.js slides in Obsidian", "advanced slides", or asks to convert a document, notes, or content into a presentation. Also trigger when the user wants to edit, improve, or restructure an existing Obsidian slides file, add speaker notes to slides, change slide themes, or apply layouts like split/grid to existing slide content. Even if the user just says "make me a presentation" or "turn this into slides", use this skill — it produces .md files compatible with the obsidian-advanced-slides plugin.
This skill generates .md files that work with the obsidian-advanced-slides plugin for Obsidian. The output is a single Markdown file with YAML frontmatter and slide separators that renders as a reveal.js presentation inside Obsidian.
Before writing any slides, read references/syntax-reference.md in this skill folder for the full syntax details, layout components, frontmatter options, and examples. That file is your authoritative guide — do not guess at syntax.
Analyze the source content. Identify the main sections, key messages, supporting data, and natural groupings. Determine the audience and tone.
Choose a theme and frontmatter settings. Pick a theme that matches the tone (see reference). Set up frontmatter with appropriate options for controls, slideNumber, progress, transition, etc. Ask the user if they want any specific RevealJS features enabled (chalkboard, elapsed time bar, overview mode, laser pointer).
Design the slide structure. Plan horizontal slides (---) for main sections and vertical slides (--) for sub-topics within a section. Aim for one key idea per slide. Keep text concise — slides are visual aids, not documents.
Write speaker notes. Every content slide should have a note: section with what the presenter should say or emphasize. Speaker notes are the expanded explanation that doesn't belong on the slide itself.
Apply layouts. Use <split> and <grid> components where content benefits from multi-column or positioned layout. Use them sparingly — not every slide needs a complex layout.
Add visual enhancements. Use fragmented lists (+ for unordered, ) for ordered) when content should appear incrementally. Use slide backgrounds for section dividers or emphasis slides. Use element annotations for styling individual elements.
Output the file. Save as .md to /mnt/user-data/outputs/ with a descriptive filename.
Keep slides lean. A slide with 3-5 bullet points or a single key statement plus supporting visual is ideal. If you find yourself putting a wall of text on a slide, split it into multiple slides or move detail to speaker notes.
Use vertical slides for depth. The main horizontal flow should tell the story at a high level. Vertical slides let the presenter dive deeper on a topic when needed without disrupting the main narrative.
Section dividers matter. Use a slide with a large heading and a background image/color to mark major topic transitions. This gives the audience a visual break and signals a new chapter.
Speaker notes are essential. The presenter needs to know what to say. Write notes in natural language as if coaching the presenter: "Emphasize that this correlation is lower than expected. Pause here for questions."
Fragmented lists for storytelling. When revealing points one at a time helps the narrative, use + instead of -. Don't fragment everything — only when the reveal order adds value.
"Convert this document to slides" — Read the document, identify 5-10 main topics, create a title slide, one section per topic with sub-slides as needed, and a closing slide. Add speaker notes derived from the document's detailed text.
"Add speaker notes" — Read existing slides, write contextual notes for each slide based on the content and flow.
"Change the theme" — Update the theme: frontmatter property. Adjust background colors if they conflict with the new theme.
"Make it more visual" — Add grid/split layouts, slide backgrounds, fragmented reveals, and section divider slides.
"Enable/disable features" — Toggle frontmatter properties like enableChalkboard, enableOverview, enableTimeBar, controls, slideNumber, progress, etc.
---