Export slide deck to HTML, PDF, PPTX, and image 🛡️

We have integrated Marp CLI to export your deck into several formats.

To export the content of active Markdown editor, open the quick pick from Marp icon on toolbar and select "Export slide deck..." . ( markdown.marp.export )

You can also execute command from the Command Palette (F1 or Ctrl/Cmd+Shift+P).

Supported file types

Default file type can choose by the markdown.marp.exportType setting.

[!IMPORTANT] Exporting PDF, PPTX, and image formats requires to install any one of Google Chrome , Chromium , Microsoft Edge , or Firefox . You may control using browser and the custom path for the browser by markdown.marp.browser and markdown.marp.browserPath settings.

[!NOTE] A legacy setting markdown.marp.chromePath is deprecated since v2. Please use markdown.marp.browserPath instead.

Integration with GitHub Copilot agent mode

Marp for VS Code also provides the export tool for GitHub Copilot agent mode .

By instructing to export Markdown in the specified file format, Copilot in the agent mode can process the export using preferences in the current workspace.

Use custom theme CSS 🛡️

You can register and use custom theme CSS for Marpit / Marp Core by setting markdown.marp.themes , that includes remote URLs, or relative paths to local files in the current workspace.

// Please put `.vscode/settings.json` on your workspace
  "markdown.marp.themes": [
    "https://example.com/foo/bar/custom-theme.css",
    "./themes/your-theme.css"
It's very similar to a way for using custom styles in ordinary Markdown preview. The registered theme can use by specifying theme name in theme global directive.
/* @theme your-theme */
@import 'default';
section {
  background: #fc9;
marp: true
theme: your-theme
# Use your own theme
Markdown preview will reload updated theme CSS automatically when you edited the registered local CSS file. It's very useful for creating your own theme.
Outline extension
When Marp Markdown is enabled, you can use the extended outline view like following. They are enabled by default but you may disable by the markdown.marp.outlineExtension setting.
Outline view for each slide
We extend the outline view to support slide pages in Marp Markdown.
[!TIP]
Please choose Sort By: Position from context menu of its panel if you see incorrect slide order.
Slide folding in editor
You can fold the content of slide in editor while editing Marp Markdown.
Security
Workspace Trust
Some features that may met malicious are restricted in the untrusted workspace/window. Please read VS Code's user guide for details.
Features may be restricted are marked by the shield icon 🛡️ in this documentation. Marp for VS Code is available even if the current workspace is not trusted but you can use only a basic Marp preview and IntelliSense.
HTML elements in Markdown 🛡️
In the trusted workspace, if Marp Markdown was included HTML elements, only selectivity HTML elements by Marp can render by default. You can control which HTML elements will be rendered by setting the markdown.marp.html option,
You can control which HTML elements will be rendered by setting the markdown.marp.html option. You can set it as all to allow all HTML elements, but could allow script injection from untrusted Markdown files. Use with caution.
In the untrusted workspace, HTML elements in Marp Markdown will be always ignored regardless of the selected option in markdown.marp.html.
[!NOTE]
A legacy setting markdown.marp.enableHtml is deprecated since v2. Please use markdown.marp.html instead.
Experimental settings
Some of settings are marked as experimental. These feature may be unstable and change the spec in the future.
markdown.marp.pptx.editable
You can enable the experimental feature to export PPTX with editable contents, based on Marp CLI's corresponding experimental option. This feature requires to install both of the compatible browser and LibreOffice Impress.
If set this setting as smart, Marp for VS Code will try to export into editable PPTX first, and then fallback to the regular PPTX export (non-editable) if failed.
markdown.marp.strictPathResolutionDuringExport
This experimental setting is useful to improve the export result compatibility with VS Code preview. If enabled, the export command will try to resolve relative paths in Markdown from VS Code workspace that a Markdown file belongs.
If disabled, or the Markdown does not belong to any workspace, the export command will resolve paths based on the local file system. This behavior is same as Marp CLI.
Web extension
You can use Marp extension in VS Code for the Web environment like vscode.dev and github.dev. Try opening https://github.dev/marp-team/marp-vscode/blob/main/docs/example.md, with an environment that has installed Marp extension.
The web extension has some limitations:
Export command cannot use because it is depending on Marp CLI that is not designed for Web. Please use VS Code that is installed to your local environment, or use either VS Code Server or GitHub Codespaces if you wanted an environment working on Web.
Contributing
Are you interested in contributing? Please see CONTRIBUTING.md and the common contributing guideline for Marp team.
Author
Managed by @marp-team.
 Yuki Hattori (@yhatt)
License
This extension releases under the MIT License.