# Turn Markdown into editable slides

[Canonical article](https://slides.com/docs/import-from-markdown)

Slides can turn Markdown into editable presentation slides. You can create a complete deck from a Markdown document or insert a few Markdown slides into a deck you are already editing.

Separate slides by placing three dashes on their own line:

```markdown
# First slide

An opening statement.

---

# Second slide

- First point
- Second point
```

Slides supports common Markdown formatting, including headings, bold and italic text, links, block quotes, and ordered and unordered lists.

## Create a new deck from Markdown

1. Open the [Markdown to Presentation converter](https://slides.com/tools/markdown-to-presentation).
2. Write or paste your Markdown into the editor.
3. Review the slide previews as you work.
4. Select **Create presentation** when the slides are ready.

You can continue editing the generated text and adjust the presentation's theme and layout in the visual editor.

<img src="https://static.slid.es/help/markdown-importing/markdown-converter-88d13924.jpg" alt="Markdown presentation converter with source text and three slide previews" width="1280" height="720">

## Insert Markdown into an existing deck

1. Open the deck in the editor and navigate to the slide after which you want to add content.
2. Select the button for adding a horizontal or vertical slide.
3. Under **Tools**, select **Insert markdown**.
4. Write or paste your Markdown and review the previews.
5. Select **Insert slide** or **Insert slides**.

The new slides are placed immediately after the current slide in the direction you selected. You can also press <kbd>⌘ ⇧ M</kbd> on macOS or <kbd>Ctrl ⇧ M</kbd> on Windows to open the importer for horizontal slides.

<img src="https://static.slid.es/help/markdown-importing/insert-markdown-option-f7a9c724.jpg" alt="Slide template chooser with Insert markdown under Tools" width="1280" height="720">

## Import through the Import panel

For a larger document, open the editor's **Import** panel and select **Import Markdown**. If the deck already contains slides, Slides asks whether you want to append the imported slides or replace the existing slides.

Replacing slides removes the deck's current slide content. If you choose the wrong option, use <kbd>⌘ Z</kbd> on macOS or <kbd>Ctrl Z</kbd> on Windows immediately after the import to undo it.