Skip to content

KovaMD/Kova

Repository files navigation

Kova

Kova turns plain Markdown into polished slides — with live preview, multiple layouts, theming, and PPTX export — all in a native desktop app.

Latest release Service status


Write. Present.


Everything you need

  • Auto-detected layouts: title, section, two-column, split, code, math, grid, and more
  • Live preview as you type
  • Syntax highlighting via highlight.js
  • Math via KaTeX — $E = mc^2$ and $$...$$ blocks

|||

  • Mermaid diagrams — pie, bar, line, flowchart
  • 11 built-in themes, community library, custom YAML
  • Fullscreen presentation mode with speaker notes
  • PPTX export (16:9 and 4:3)

Syntax highlighting

// Separate slides with ---. Kova auto-detects the layout.
function makeSlides(markdown: string): Slide[] {
  return markdown
    .split(/^---$/m)
    .map(parseSlide)
    .filter(Boolean)
}

$$ E = mc^2 \qquad \frac{d}{dx}!\left(e^x\right) = e^x \qquad \int_0^\infty e^{-x},dx = 1 $$


pie title Slide layouts in a typical deck
  "title-content" : 35
  "two-column" : 20
  "section" : 15
  "code" : 15
  "split / BSP / grid" : 15
Loading

The Kova workflow

Open any Markdown file. Separate slides with --- and Kova detects the layout automatically.

## Quarterly Review

Revenue grew **32%** YoY.

- Customer count: 1,240
- NPS score: 72
- Churn rate: 2.1%

A live preview updates in real time as you type.


Plain text in. Polished slides out.


Download

Platform Download
macOS (Apple Silicon + Intel) Download .dmg
Windows 10/11 Download .msi · Setup .exe
Linux (Debian/Ubuntu) .deb package · or via package manager
Linux (Fedora/RHEL/openSUSE) .rpm package · or via package manager

Linux package managers

Debian / Ubuntu

sudo curl -fsSL https://deb.kova.md/key.gpg \
  | sudo gpg --dearmor -o /etc/apt/keyrings/kova.gpg
echo "deb [signed-by=/etc/apt/keyrings/kova.gpg] https://deb.kova.md stable main" \
  | sudo tee /etc/apt/sources.list.d/kova.list
sudo apt update && sudo apt install kova

Debian 13+ — use the DEB822 source format.

|||

Fedora / RHEL / openSUSE

sudo rpm --import https://rpm.kova.md/key.gpg
sudo curl -o /etc/yum.repos.d/kova.repo \
  https://rpm.kova.md/kova.repo
sudo dnf install kova   # openSUSE: zypper install kova

Features

  • Markdown-first — write slides in plain text, separated by ---
  • Auto layout — title, section, split, two-column, grid, quote, full-bleed, and more
  • Live preview — editor and preview stay in sync as you type
  • Syntax highlighting — fenced code blocks rendered with highlight.js
  • Math & LaTeX — inline and block math via KaTeX ($...$ and $$...$$)
  • Mermaid diagrams — pie, bar, line charts and flowcharts inline
  • Themes — 11 built-in themes, community themes, and custom YAML

|||

  • Focus mode — dims non-active slides, collapses side panels
  • Fullscreen presentation — speaker notes, slide counter, keyboard and click navigation
  • PPTX export — export to PowerPoint (16:9 and 4:3)
  • YouTube & poll embeds!youtube[label](url) and !poll[label](url)
  • File watcher — reloads automatically when the file is edited externally
  • Keybindings — configurable via ~/.kova/keybindings.yaml

Building from source

Prerequisites: Node.js 18+, Rust (stable), and Tauri prerequisites for your platform.

git clone https://github.com/KovaMD/Kova.git
cd Kova
npm install
npm run tauri dev      # development — hot-reload
npm run tauri build    # release binary

See the Contributing guide for more details.


Keybindings

To customise, edit your keybindings file (created automatically on first launch), or open it from Settings → Keyboard Shortcuts → Open file.

Platform Path
macOS ~/Library/Application Support/kova/keybindings.yaml
Linux ~/.config/kova/keybindings.yaml
Windows %APPDATA%\kova\keybindings.yaml

Custom themes follow the same base path, under a themes/ subfolder. Full reference on the Keyboard Shortcuts wiki page.


Themes

Theme library — open the Inspector, expand Theme, and click More Themes… to browse and install community themes from the KovaMD/Themes repository. Each download is verified against a SHA-256 checksum. Installed themes appear in the picker immediately.

Custom themes — place YAML theme files in the themes/ subfolder of your config directory (see Keybindings above for platform paths). They appear in the Inspector alongside built-in themes. See the Themes wiki page for the full YAML format.


License

Kova is free and open source software, released under the GNU General Public License v3.0.

You are free to use, study, modify, and distribute this software under the terms of the GPL v3. Any modified versions distributed to others must also be made available under the GPL v3.

See LICENSE for the full license text.


© 2026 Kova contributors

About

Kova - Markdown presentation editor.

Resources

License

Stars

Watchers

Forks

Sponsor this project

Contributors