Marp Presentations

Bokuchi can render Markdown files as slide presentations using Marp. Write your slides in Markdown and preview them as a presentation — no separate presentation software needed.

Enabling Marp

Marp is disabled by default. To enable it:

1. Open Settings with Cmd+, (macOS) or Ctrl+, (Windows/Linux)
2. Go to Advanced > Rendering Extensions
3. Turn on Marp (Presentations)

Note

When Marp is disabled, its library is not loaded, so there is no impact on editor performance.

Writing a Presentation

Add marp: true to the YAML front-matter at the top of your Markdown file. Separate slides with --- (three hyphens on their own line).

---
marp: true
---

# Slide 1

Welcome to my presentation!

---

# Slide 2

- Point A
- Point B
- Point C

---

# Slide 3

Thank you!

When Bokuchi detects marp: true in the front-matter, the preview automatically switches to presentation mode.

View Modes

Marp presentations behave differently depending on the current view mode:

Split View (Ctrl+Shift+1)

All slides are displayed vertically in the preview pane. The editor and slides scroll together, so you can see which slide you are editing.

Preview Only (Ctrl+Shift+3)

Slides are displayed one at a time with navigation controls:

Action	Shortcut
Next slide	Right arrow / Down arrow / Space
Previous slide	Left arrow / Up arrow
Exit fullscreen	Escape

A slide counter at the top shows your current position (e.g., “Slide 2 of 10”).

Fullscreen

Click the fullscreen button in the preview header to display the current slide in a 16:9 aspect ratio on a dark background. Press Escape to exit fullscreen.

Thumbnail Grid

Click the grid button in the preview header to see all slides at a glance. Click any thumbnail to jump to that slide.

Themes

Marp supports built-in themes. Specify a theme in the front-matter:

---
marp: true
theme: gaia
---

Available Marp themes include default, gaia, and uncover.

Custom Themes

Beyond the built-in themes, you can register your own Marp themes from a folder of CSS files.

1. Open Settings > Advanced (Marp must be enabled).
2. Under Marp Theme Folder, click Choose Folder… and select a folder containing your .css theme files.
3. Bokuchi scans the folder and lists the themes it finds. Use Reload if you add or change files, or Clear to remove the folder.

Each CSS file becomes a selectable theme as long as it starts with an @theme header naming the theme:

/* @theme my-theme */

section {
  background: #fdf6e3;
  color: #333;
}

Then reference that name in your slide’s front-matter, just like a built-in theme:

---
marp: true
theme: my-theme
---

Note

Files without an @theme header are ignored — Bokuchi lists them separately so you can see why they weren’t picked up.

Images

Relative image paths in your Markdown work inside Marp presentations. Bokuchi automatically resolves them so that images display correctly in the preview.

---
marp: true
---

![Diagram](./images/diagram.png)

Next Steps

• Editor & Preview — Learn about view modes and synchronized scrolling
• Export — Export your documents
• Settings — Configure rendering extensions