Quick start
Create the source
Save this as my-talk.md. The literal [요약] marker means “summary” and is checked by the current structured-notes validator (NOTE_STRUCTURE is a warning when the marker is missing); the notes themselves remain English.
---
remarp: true
title: "Build with evidence"
speaker:
name: "Alex Morgan"
title: "Engineer"
company: "Example team"
audience: "Project contributors"
level: "200"
quiz: false
duration: 5
lang: en
---
# Build with evidence
A short introduction to the review loop.
:::notes
{timing: 2min}
[요약]
- Introduce the review loop.
- Connect each change to observable behavior.
- Explain how the checks support the conclusion.
Introduce the example and ask the audience to keep one recent change in mind.
Explain that the next slide separates reading the code, exercising its behavior,
and recording what the result proves. This keeps the review concrete and gives
the next reviewer enough evidence to reproduce the conclusion.
:::
---
@type: content
## Verify each change
- Read the affected code {.click order=1}
- Run the relevant checks {.click order=2}
- Record the result {.click order=3}
:::notes
{timing: 3min}
[요약]
- Start from the changed behavior.
- Choose checks that exercise it.
- Report evidence and limits.
Explain why a successful build alone may not exercise the changed behavior.
Walk through one relevant test and describe what its passing result proves.
{cue: transition}
Next, use the same method when reviewing a teammate's change.
:::
Validate and build
Run from the marketplace repository root:
python3 plugins/aws-content-plugin/skills/reactive-presentation/scripts/remarp_to_slides.py validate my-talk.md
python3 plugins/aws-content-plugin/skills/reactive-presentation/scripts/remarp_to_slides.py build my-talk.md --lang en
validate exits nonzero for invalid or missing input or CRITICAL findings. build and sync enforce the same validation gate; style warnings remain advisory. Add --json to validate for machine-readable diagnostics.
This source builds to slides/default.html with CSS and JavaScript copied automatically into slides/common/. Use -o /var/tmp/my-talk to write default.html and common/ there instead. Open slides/default.html and exercise the fragments. Right/Space advances; Left reverses; P opens presenter view. Run content review before publication.
Extend the deck
Use @type for compare/tabs/quiz/checklist/timeline/Canvas slides, @layout for columns, and :::notes for speaking guidance. For multi-file decks put shared frontmatter in _presentation.md or _presentation.remarp.md. Building the project directory places index.html, toc.html, block HTML and common/ beside the source unless -o selects another directory.
After source, metadata or dependency edits, run sync on the project directory to regenerate the complete deck, TOC and assets. It does not depend on Markdown timestamps. See the CLI reference for commands and options.