Docs.
The same pages that ship inside Sigla. Browse here, or open them from the Help menu in the app.
-
Getting started
Sigla is a native macOS Markdown reader. It renders GitHub Flavored Markdown plus KaTeX math, Mermaid, Vega-Lite, PlantUML, Graphviz, Gherkin, and CSV/TSV tables — all offline, all rendered the same way every time.
-
Keyboard shortcuts
Every keyboard shortcut Sigla binds, organized by area. The menu-bar location in parentheses is where to find the same action if you forget the chord.
-
Settings — Renderers
The Renderers pane in Settings (`⌘,` → Renderers) is the central control panel for every block renderer Sigla knows about — both the compiled-in built-ins (Mermaid, Vega-Lite, CSV/TSV) and the manifest-driven extensions discovered at launch (bundled and user-installed).
-
Themes
Sigla has three built-in document themes and supports custom CSS themes you drop into a config directory. Dark mode is an orthogonal toggle that flips the appearance of whichever theme is active.
-
Extensions overview
Extensions are manifest-driven fence-block renderers. They add new rendered output to Sigla without modifying the app itself — a directory with a `sigla.json` manifest plus, optionally, some assets and a `process` binary spec.
-
Extensions — authoring
This page is the manifest-schema reference and worked-example tour. For a higher-level orientation, read [Extensions overview](./05-extensions-overview.md) first. The bundled `plantuml`, `graphviz`, and `gherkin` extensions inside `Sigla.app/Contents/Resources/Extensions/` are the canonical worked examples — copy one as a starting point.
-
CLI reference
Sigla ships a command-line tool, `mdv`, alongside the app. The brew cask also installs two aliases: `sigla` (forward-looking name) and `mdview` (legacy, 12-month sunset). All three share the same binary and behave identically; `mdview` additionally prints a one-line deprecation notice.
-
PDF export
Sigla exports any Markdown document as a presentable, WYSIWYG PDF — same renderer, same fonts, same diagrams, same code highlighting as the screen view. There are two surfaces: the GUI preview window and the `mdv export` command-line subcommand.
-
Comments and highlights
Sigla supports inline comments anchored to spans of prose in your Markdown documents. Comments live in a hidden sidecar file next to the source — they travel with the file in git/Dropbox/etc., and the source itself is never mutated.
-
Folder workspace
Single Markdown files are fine for a quick look. For anything bigger — a notes vault, a project's docs tree, a manuscript — open the whole folder as a workspace. You get a sidebar, table of contents, frontmatter panel, recent-folders list, and cross-file wikilinks.
-
Search and find
Sigla has two search surfaces: a find-in-document bar for the file you're reading, and a folder-search modal for cross-file queries.
-
Upgrading from MarkdownViewer
In v0.4.0 the app was renamed from **MarkdownViewer** to **Sigla**. The bundle identifier changed too, which scopes a fresh `UserDefaults` domain — so without a migration shim every existing user would lose every preference the app had ever written. Sigla migrates them automatically on first launch.
-
Using with Claude
Sigla ships two bundled [Claude](https://claude.ai) skills — small, self-contained knowledge packets that teach Claude (Claude Code, Claude.ai, any skill-aware host) what Sigla is, how its CLI works, and how to author extensions. Drop them into your Claude config once and Claude stops asking you to re-explain manifest fields, scheme handlers, or fence-label resolution on every conversation.