Orbitant Marp Theme

Marp theme based on the Orbitant Knowledge Sharing PowerPoint template.

Preview

| Title | Index | Content | | :-------------------------------: | :-------------------------------: | :---------------------------------: | | | | | | <!-- _class: title --> | <!-- _class: index --> | default |

| Accent | Light | Code | | :--------------------------------: | :-------------------------------: | :------------------------------: | | | | | | <!-- _class: accent --> | <!-- _class: light --> | default |

Setup

npm install @orbitant/marp-theme @marp-team/marp-cli

Create a .marprc.yml in your project:

theme: node_modules/@orbitant/marp-theme/orbitant.css
html: true

That's it. Now any .md file in your project can use the theme:

---
marp: true
theme: orbitant
paginate: true
---

<!-- _class: title -->

# My Presentation Title

## Speaker Name

---

# Content Slide

- Point one
- Point two
- Point three

Build with:

npx marp slides.md            # HTML
npx marp --pdf slides.md      # PDF
npx marp --pptx slides.md     # PowerPoint
npx marp --preview slides.md  # Open in browser with live reload

VS Code

Install the Marp for VS Code extension, then add to your .vscode/settings.json:

{
  "markdown.marp.themes": ["node_modules/@orbitant/marp-theme/orbitant.css"],
  "markdown.marp.enableHtml": true
}

You'll get live preview in the editor.

Slide classes

Use <!-- _class: classname --> before a slide to apply a layout:

| Class | Description | | -------------- | ---------------------------------------- | | title | Cover slide with full orbital background | | section | Chapter divider | | accent | Blue left border accent | | light | White background variant | | light accent | White background + blue left border | | index | Table of contents | | cols | Two-column grid layout | | lead | Large centered text | | end | Closing / thank you slide |

Full example

---
marp: true
theme: orbitant
paginate: true
---

<!-- _class: title -->

# Knowledge Sharing Title

## Speaker Name

---

<!-- _class: index -->

### Index

# 01 Introduction

## 02 Architecture

## 03 Demo

## 04 Q&A

---

<!-- _class: section -->

# Introduction

## Context and motivation

---

# Regular Content Slide

- Bullet points work as expected
- **Bold** and _italic_ supported
- Links: [example](https://example.com)

---

<!-- _class: accent -->

# Accent Slide

> Blockquotes get a blue left border and subtle background.

---

<!-- _class: light -->

# Light Background

Good for screenshots, diagrams, and tables.

| Feature | Status |
| ------- | ------ |
| Auth    | Done   |
| API     | WIP    |

---

<!-- _class: end -->

# Thank You!

Questions?

Contributing

Local development

git clone https://github.com/weorbitant/marp-theme-orbitant.git
cd marp-theme-orbitant
npm install
npm run preview   # Opens example.md with live reload

Releasing a new version

Releases are triggered by git tags. Use the built-in scripts to bump the version, create a tag, and push — all in one step:

npm run release        # patch  0.1.0 → 0.1.1
npm run release:minor  # minor  0.1.0 → 0.2.0
npm run release:major  # major  0.1.0 → 1.0.0

This runs npm version under the hood, which:

1. Bumps the version in package.json
2. Creates a commit and a v* tag
3. Pushes both to the remote

The push triggers the CI/CD pipeline, which validates the tag, publishes to npm, and creates a GitHub Release with auto-generated notes.

Fonts

The theme loads Lexend and IBM Plex Sans from Google Fonts automatically. No local install needed.