Creating and Using Slides

Overview

A Slide is a content type for creating presentation materials using Markdown. Separate slides with ---, and present them in fullscreen presentation mode.

Creating a Slide

Step 1: Open the Content Creation Screen

Tap the create button (+) at the bottom-right of the screen
The content type selection screen appears
Select "Slide"

Step 2: Enter Basic Information

Fill in the following fields:

Required Fields

Title: The title of your Slide (e.g., "Q2 2025 Progress Report")
Visibility: Choose from PRIVATE / TEAM / PUBLIC

Optional Fields

Description: A summary of the slide (displayed in search results and content cards)
Category: Select a category to classify the slide
Parent folder: Choose a folder to place the slide in

Step 3: Write the Slides

Type your content in the Markdown textarea. Use --- to separate individual slides.

Basic Slide Structure

# First Slide

Write your content here

---

## Second Slide

- Bullet point 1
- Bullet point 2
- Bullet point 3

---

## Third Slide

| Item | Value |
|------|-------|
| A    | 100   |
| B    | 200   |

Step 4: Preview

The right side of the editor shows a thumbnail list of your slides. You can check each slide's layout as you write.

Step 5: Save

Once you are ready, click the "Create" button to save your slide.

Slide Display Modes

Slides have two display modes.

Slide List View

Opening a slide's detail page shows all slides as thumbnails.

Quickly check the total number of slides
See the content of each slide at a glance

Presentation Mode

Use Presentation Mode when you are ready to present.

How to launch:

Open the slide's detail page
Click the "Present" button
The slide fills the screen in fullscreen

Controls:

Action	Description
Right arrow / Space	Go to next slide
Left arrow	Go to previous slide
Esc	Exit presentation mode
Swipe (mobile)	Swipe left/right to change slides

Using Markdown in Slides

Headings

Use # for slide titles and ## for section headings.

# Slide Title
## Section Heading
### Subheading

Bullet Lists

Summarize key points as a bulleted list.

## Today's Agenda

- Introduction
- Current status
- Challenges and solutions
- Wrap-up

Numbered Lists

Use numbered lists when order matters.

## Implementation Steps

Define requirements
Design
Implement
Test
Deploy

Tables

Use tables to compare options or display structured data.

## Comparison

| Feature | Plan A | Plan B |
|---------|--------|--------|
| Users | 5 | 20 |
| Storage | 10 GB | 50 GB |
| Support | Email only | Phone + Email |

Code Blocks

Show code clearly in technical presentations.

## Sample Code

```javascript
function hello(name) {
  return `Hello, ${name}!`;
}
```

Block Quotes

Highlight memorable quotes or key phrases.

## A Guiding Principle

> A journey of a thousand miles begins with a single step.

Inserting Images

## Architecture Diagram

![Architecture](https://example.com/diagram.png)

Practical Examples

Example 1: Project Progress Report

# Project A Progress Report

Q2 2025

---

## Agenda

1. Project overview
2. Current progress
3. Challenges
4. Next steps

---

## Project Overview

**Goal**: Build a new customer management system

- Timeline: April – September 2025
- Team: 6 members
- Budget: ¥5,000,000

---

## Progress Summary

| Phase | Planned | Actual | Status |
|-------|---------|--------|--------|
| Requirements | End of April | April 25 | Done |
| Design | End of May | June 10 | Delayed |
| Implementation | End of July | In progress | On track |

---

## Challenges and Actions

**Challenge**: Design phase delayed by two weeks

**Root causes**:
- Changes in client requirements
- Technical research took longer than expected

**Actions**:
- Added two engineers to the implementation team
- Moved part of the scope to a later phase

---

## Next Steps

1. Accelerate implementation (by end of July)
2. Mid-project review (first week of August)
3. Start testing (mid-August)

Example 2: Study Session Materials

# React Fundamentals

Hands-on for Beginners

---

## What is React?

- A JavaScript library for building UIs
- Developed and maintained by Meta (Facebook)
- Component-based architecture

---

## Component Basics

```javascript
function Hello({ name }) {
  return <h1>Hello, {name}!</h1>;
}

Key points:

Define UI as a function
Embed JavaScript expressions with {}

Summary

React builds UIs from components
Pass data from parent to child using Props
Manage changing data with State


---

## Editing a Slide

### Opening the Editor

1. Open the slide you want to edit
2. Click the **"Edit"** button in the upper right
3. The edit screen appears

### Saving Your Changes

- When you are done editing, click the **"Save"** button
- Changes are applied immediately

---

## Tips and Tricks

### 1. One message per slide

Keep each slide focused on a single message or key point. Avoid cramming too much information onto one slide.

### 2. Use headings to guide the flow

Clear slide titles (`#` or `##`) help your audience follow the structure of your presentation.

### 3. Use tables to show comparisons

When comparing multiple options, a table communicates the differences at a glance.

### 4. Keep code snippets short

For technical presentations, show only the essential parts of your code. Long code listings are hard to read on a slide.

---

## FAQ

### Q1: Is there a limit on the number of slides?

**A**: There is no hard limit. For readability, most presentations work best with 25–30 slides or fewer.

### Q2: Can I change the theme or design?

**A**: You can specify a theme using Marp-compatible Front Matter at the top of your slide content.

```markdown
---
marp: true
theme: default
---

# Title

Q3: The presentation mode doesn't fill the screen — what should I do?

A: Try combining with your browser's fullscreen mode (F11) for a larger display.

Q4: Can I export slides as a PDF?

A: You can save slides as a PDF using your browser's "Print" function and selecting PDF as the destination.