Markdown reference

Markdown syntax reference

A searchable reference for Markdown and slide syntax verified with Marplio.

Basic Markdown

Standard syntax for structuring and emphasizing content.

Headings and text

Start a line with `#` and add a space after the marker.

Example
# Main heading

## Subheading

Plain text becomes body copy.
Result
The content is rendered as a heading, subheading, and body text.

Emphasis

Use bold, italic, and strikethrough where needed.

Example
**Bold**

*Italic*

~~Strikethrough~~
Result
Only the marked text is emphasized.

Bullet list

Start each line with `-` and a space.

Example
- Research
- Prototype
- Validate
Result
The items are displayed as a bullet list.

Numbered list

Start each line with a number, period, and space.

Example
1. Research
2. Prototype
3. Validate
Result
The items are displayed in order.

Quote

Start a line with `>` and a space.

Example
> Lead with the conclusion that matters.
Result
The sentence is styled as a quote.

Link

Wrap the label in brackets and the URL in parentheses.

Example
[Marplio](https://marplio.com)
Result
The label becomes a clickable link.

Inline code

Wrap short code or symbols in one backtick.

Example
Run `npm run build`.
Result
The code is distinguished within the sentence.

Code block

Wrap multiple lines in three backticks and optionally add a language.

Example
```ts
const message = "Hello, Marplio";
```
Result
The code keeps its line breaks and syntax highlighting.

Table

Use pipes for columns and a separator row below the headings. Use `<br>` for a line break within a cell.

Example
| Metric | Result |
| --- | --- |
| Users | +28%<br>MoM |
| Time | -2h |
Result
The content is rendered as a table with a heading row.
Current limitation
Keep the number of columns and the amount of text small enough for one slide.

Marp and Marplio syntax

Syntax for splitting pages and assigning slide roles.

Format pasted Markdown

Paste Markdown with one H1 and one or more H2 headings into an empty editor, or replace the entire document, to split it into slides by heading.

Result
The first heading becomes a cover and following headings become content slides. Common copied bullet and numbered-list markers are normalized to Markdown.
Current limitation
Existing Decks with `---` or `_class`, fenced code, and frontmatter are preserved. One Undo returns to the state before the paste.

Separate slides

Use `---` on its own line to begin the next slide.

Example
# Slide one

---

# Slide two
Result
The source is rendered as two slides.

Page numbers

Place the paginate directive at the start to number following slides.

Example
<!-- paginate: true -->

# Slide one

---

# Slide two
Result
A page number is displayed on each slide.

Fit a heading to the width

Place `<!-- fit -->` in a heading to scale it to the available width.

Example
# <!-- fit --> Build less. Prove more.
Result
The heading scales up or down to fit the available width.
Current limitation
Fit is not a fixed size. Reserve it for short statements.

Slide roles

Review the purpose and appropriate content density for covers, agendas, section covers, content, and closing slides.

Cover `cover`

`cover` is the opening slide. Use `#` for the subject and `##` for supporting context.

Example
<!-- _class: cover -->

# Make decision-ready decks faster.

## Monthly reporting workflow

2026.09 / Product team
Best for
Open a Deck with a concise topic, audience, and presenter.
Avoid when
Long body copy and dense lists weaken the main message.
Structure
One `#`, optionally one `##`, and short metadata.
Result
The selected design is applied as the Deck cover.

Agenda `agenda`

`agenda` is the table of contents. Put a numbered list after one `##`.

Example
<!-- _class: agenda -->

## Today's agenda

1. Current state
2. Proposal
3. Delivery plan
4. Decision
Best for
Orient the audience before a Deck with three to six chapters.
Avoid when
Keep explanations out of the list and use chapter names only.
Structure
One `##` followed by three to six numbered items.
Result
Chapter numbers and names are arranged as a readable agenda.

Section cover `section-cover`

`section-cover` divides chapters. Use `#` for the chapter number and `##` for its name.

Example
<!-- _class: section-cover -->

# 01

## Current state

Start with the cause that delays decisions.
Best for
Reset attention when the subject changes substantially.
Avoid when
Do not place detailed evidence or conclusions on a divider.
Structure
One `#`, one `##`, and optionally one short sentence.
Result
The chapter number and name become a focused divider slide.

Content `content`

`content` is the standard body slide. Use `##` for the point the slide must communicate.

Example
<!-- _class: content -->

## Cut reporting work in half

- Standardize inputs
- Review differences only
- Record the decision and next action
Best for
Explain one claim through evidence, interpretation, and action.
Avoid when
Keep one claim per slide and write the heading as the conclusion.
Structure
One `##` followed by body text or three to five list items.
Result
A standard slide with a heading and body is displayed.

Closing `closing`

`closing` is the final slide. Put the conclusion or action to remember in `#`.

Example
<!-- _class: closing -->

# Choose the pilot scope at the next meeting.

Select the first team by October 3.
Best for
Restate the conclusion, request, or next action at the end.
Avoid when
Do not end with only “Thank you”; state the decision you need.
Structure
One `#`, optionally followed by a deadline or contact detail.
Result
The Deck ends with a strong, focused conclusion.

Content layouts

Add a presentation class to `content` and choose a layout that matches the relationship you need to communicate. Preview every example in each design.

Quote `quote`

`quote` makes a quotation the focal point.

Example
<!-- _class: content quote -->

## Customer voice

> Monthly reporting now creates time for decisions.

— Business owner
Best for
Highlight a short sourced statement, customer voice, or principle.
Avoid when
Do not style ordinary explanation as a quote only for decoration.
Structure
One `##`, one quote, and optionally one source line.
Result
The quote is enlarged with deliberate spacing and quotation styling.

Compare two text groups `two-column`

`two-column` aligns two subheadings and their text side by side.

Example
<!-- _class: content two-column -->

## Two options

### Keep the current process

Start quickly, but retain manual work.

### Standardize the workflow

Prepare once, then reuse it next time.
Best for
Compare two short text groups with equal weight, such as today and next.
Avoid when
Avoid it when the two sides differ substantially in detail or length.
Structure
One `##`, two `###`, and one paragraph or list after each subheading.
Result
Two perspectives appear at equal width and aligned vertical positions.

Place mixed content in columns `columns`

`columns` explicitly separates headings, text, lists, or diagrams into left and right regions.

Example
<!-- _class: content columns -->

## Funnel and next action (sample)

<!-- marplio:column left -->

### Evidence

- Audience and current state
- Numbers needed for the decision

<!-- marplio:column right -->

### Interpretation

This content and its values are examples. Replace them with verified evidence.

- What changed
- What to test next
Best for
Place different content types side by side, such as a visual and explanation.
Avoid when
Three columns, nested columns, and missing column markers are unsupported.
Structure
`content columns` plus standalone left and right marker comments.
Result
The two regions remain separate and supported exports retain editable elements.

Emphasize the left visual `columns-visual-left`

`columns-visual-left` makes the left region wider than the right.

Example
<!-- _class: content columns columns-visual-left -->

## Use width to make the focal point clear

<!-- marplio:column left -->

### Primary evidence

**31%** proposal rate

Improved 4pt month over month

<!-- marplio:column right -->

### Interpretation

The focused initiative contributed to the improvement.
Best for
Make a visual, table, or metric on the left dominant and explain it briefly on the right.
Avoid when
Use equal `columns` when neither side needs stronger emphasis.
Structure
`content columns columns-visual-left` plus standalone left and right markers.
Result
The left region uses about 58% and the right about 42% of the available width.

Emphasize the right visual `columns-visual-right`

`columns-visual-right` makes the right region wider than the left.

Example
<!-- _class: content columns columns-visual-right -->

## Use width to make the focal point clear

<!-- marplio:column left -->

### Context

Compare the same period and audience

<!-- marplio:column right -->

### Decision

**31%** proposal rate

Continue the initiative next month
Best for
Place short context on the left and a dominant result or table on the right.
Avoid when
Use equal `columns` when neither side needs stronger emphasis.
Structure
`content columns columns-visual-right` plus standalone left and right markers.
Result
The left region uses about 42% and the right about 58% of the available width.

KPI `kpi`

`kpi` arranges important values and their meaning as cards.

Example
<!-- _class: content kpi -->

## This month's key metrics

- **42** qualified opportunities / +8 MoM
- **31%** proposal rate / +4pt MoM
- **12 days** average lead time / -3 days
Best for
Summarize up to three business outcomes measured on clear terms.
Avoid when
Keep units and conditions visible, and split four or more metrics across slides.
Structure
One `##` and three bullet items beginning with a bold value.
Result
Three emphasized values and descriptions are displayed in columns.

Compare options `comparison`

`comparison` presents two options as equal cards.

Example
<!-- _class: content comparison -->

## Compare rollout options

- **Run a pilot** Validate with one team for two weeks
- **Launch at once** Define company-wide rules first
Best for
Compare two options using the same criteria and level of detail.
Avoid when
Do not force options with different evaluation criteria or more than two choices into it.
Structure
One `##` and two bullet items beginning with a bold option name.
Result
Two choices are displayed at equal width.

Timeline `timeline`

`timeline` places ordered milestones from left to right.

Example
<!-- _class: content timeline -->

## Six-week plan

1. **Week 1** Agree on scope and decision criteria
2. **Weeks 2–5** Run and measure the pilot
3. **Week 6** Continue, change, or stop
Best for
Present three milestones in chronological or execution order.
Avoid when
Do not use it for unordered items or detailed plans with more than three stages.
Structure
One `##` and three numbered items beginning with bold timing.
Result
Three milestones are displayed as ordered cards.

Three pillars `pillars`

`pillars` presents three equally weighted elements.

Example
<!-- _class: content pillars -->

## Three operating principles

- Standardize inputs
- Preserve evidence
- Reuse the work
Best for
Show three equally ranked values, principles, or strategic pillars.
Avoid when
Do not use it when the items have a priority or sequence.
Structure
One `##` followed by three bullet items.
Result
Three pillars are displayed at the same size.

Visual content `image`

`image` reserves a visual region on the right for the template artwork.

Example
<!-- _class: content image -->

## A system creates time for decisions

- Gather inputs
- Find the difference
- Decide the next action
Best for
Pair a short message with the visual area built into the selected design.
Avoid when
This class does not load a remote image and cannot place an arbitrary upload.
Structure
One `##` followed by short body text or up to three list items.
Result
Body content moves left and the selected design supplies artwork on the right.

Chart syntax

Put strict JSON in a `chart` block to visualize values. Each slide can contain one Chart.

Create from a table

Open Chart in the editor toolbar and edit the cells directly. You can also paste a range copied from Excel, Google Sheets, or CSV starting at the selected cell.

Best for
Create a Chart from tabular source data without writing JSON directly.
Avoid when
Confirm the sharing scope and source before pasting confidential data.
Structure
Labels in the first column, series names and values in following columns; up to 12 rows and 4 series.
Result
The table is converted to Chart JSON and inserted into Markdown.
Current limitation
The table input is not stored or sent. Pie and doughnut charts accept one series.

Bar chart

Compare values across categories or multiple series.

Example
```chart
{"version":1,"type":"bar","title":"Quarterly downloads","labels":["Q1","Q2","Q3","Q4"],"series":[{"name":"PDF","values":[120,180,240,310]},{"name":"PowerPoint","values":[80,130,190,260]}]}
```
Best for
Compare discrete items such as teams, products, or initiatives.
Avoid when
Use a line chart when continuous change over time is the point.
Structure
Up to 12 labels and 4 series; every values array must match the label count.
Result
Bars and a legend are displayed for the categories.
Current limitation
State the unit and reporting period in the slide heading or body.

Line chart

Show a trend across ordered values such as months or quarters.

Example
```chart
{"version":1,"type":"line","title":"Monthly users","labels":["Jan","Feb","Mar","Apr","May"],"series":[{"name":"Users","values":[120,180,260,310,420]}]}
```
Best for
Show change, turning points, or several trends over time.
Avoid when
Use a bar chart for unordered category comparison.
Structure
Up to 12 labels and 4 series, with labels ordered along the timeline.
Result
Lines, points, axes, and a legend are displayed.
Current limitation
Do not silently replace missing values with zero; align the data range first.

Pie chart

Show how each category contributes to a whole.

Example
```chart
{"version":1,"type":"pie","title":"Template usage","labels":["Business","Education","Creative","Technology"],"series":[{"name":"Usage","values":[42,25,18,15]}]}
```
Best for
Show a small number of parts that make up one whole.
Avoid when
Avoid many categories, small differences, and time-series comparison.
Structure
Exactly one series with non-negative values and at least one positive value.
Result
Each category is displayed as a segment of the circle.
Current limitation
Use a bar chart when exact comparison matters.

Doughnut chart

Show composition while preserving an open center.

Example
```chart
{"version":1,"type":"doughnut","title":"Account mix","labels":["Guest","Free","Plus","Pro"],"series":[{"name":"Users","values":[55,30,10,5]}]}
```
Best for
Show one composition with a lighter visual center.
Avoid when
Do not use it for multiple series or precise small differences.
Structure
Exactly one series with non-negative values and at least one positive value.
Result
Each category is displayed as a segment of a ring.
Current limitation
Arbitrary center text is not currently supported.

Mermaid syntax

Use a `mermaid` block for flows, interactions, states, classes, and data relationships. Use one per slide.

Flowchart

Show a process or decision flow.

Example
```mermaid
flowchart LR
A[Design] --> B[Markdown]
B --> C[Preview]
C --> D{Revise?}
D -->|Yes| E[Adjust content or layout]
E --> C
D -->|No| F{Output}
F --> G[PDF]
F --> H[PowerPoint]
F --> I[Google Slides]
```
Result
A diagram generated from the source Markdown is displayed using the selected design.
Current limitation
External links, click, HTML, init, and arbitrary style directives are disabled for safety.

Sequence diagram

Show interactions between people or services.

Example
```mermaid
sequenceDiagram
User->>Marplio: Edit Markdown
Marplio-->>User: Update preview
```
Result
A diagram generated from the source Markdown is displayed using the selected design.
Current limitation
External links, click, HTML, init, and arbitrary style directives are disabled for safety.

State diagram

Show transitions between states.

Example
```mermaid
stateDiagram-v2
[*] --> Draft
Draft --> Review
Review --> Published
```
Result
A diagram generated from the source Markdown is displayed using the selected design.
Current limitation
External links, click, HTML, init, and arbitrary style directives are disabled for safety.

Class diagram

Show classes and dependencies.

Example
```mermaid
classDiagram
class Deck {
  +String title
  +export()
}
class Template
Deck --> Template : uses
```
Result
A diagram generated from the source Markdown is displayed using the selected design.
Current limitation
External links, click, HTML, init, and arbitrary style directives are disabled for safety.

ER diagram

Show relationships between data entities.

Example
```mermaid
erDiagram
USER ||--o{ DECK : owns
DECK }o--|| TEMPLATE : uses
```
Result
A diagram generated from the source Markdown is displayed using the selected design.
Current limitation
External links, click, HTML, init, and arbitrary style directives are disabled for safety.

Current limitations

Restrictions that keep previews safe and consistent with exports.

HTML is disabled

Marplio Engine disables HTML tags in Markdown except for the safe `<br>` line break documented above.

Result
Use the supported Markdown syntax above instead.