Capability matrix

Everything Koala renders, in one page.

Koala is built for technical Markdown. That means diagrams, syntax-highlighted code, full GitHub-flavored Markdown and clean export. Here is the complete list.

Diagrams

Mermaid and D2, rendered inline.

Fenced ```mermaid and ```d2 blocks render into the document. No plugins, no preview pane swap.

Engine Diagram type Notes
MermaidFlowchartTop-down, left-right, branching
Sequence diagramActors, messages, loops, notes
Class diagramInheritance, composition
State diagramState machines, transitions
Entity-relationshipSchemas, cardinality
User journeyStep-by-step flows
Gantt chartSchedules, milestones
Pie chartProportional breakdowns
Quadrant chart2x2 matrices
Requirement diagramSpec-style requirements
Git graphBranching, commits
MindmapHierarchical idea trees
TimelineSequenced events
SankeyFlow / weight diagrams
XY chartPlots, scatter, bar
Block diagramLogical blocks
Packet diagramByte/bit layouts
KanbanBoards
ArchitectureSystem architecture
C4Context, container, component
D2FlowchartLayered, auto-layout
Sequence diagramLifelines, messages
Class / shape graphsCustom shapes, containers
ER diagramTables and relationships
Free-form graphsAny node-edge diagram D2 supports

Syntax highlighting

180+ languages, no configuration.

Fenced code blocks pick up syntax highlighting automatically. The full list comes from highlight.js - common languages shown below, everything else is supported too.

Backend / systems

  • go
  • rust
  • c
  • c++
  • java
  • kotlin
  • scala
  • elixir
  • erlang
  • haskell
  • ocaml
  • nim
  • zig

Web / frontend

  • typescript
  • javascript
  • jsx
  • tsx
  • html
  • css
  • scss
  • less
  • svelte
  • vue

Scripting

  • python
  • ruby
  • perl
  • lua
  • bash
  • zsh
  • powershell
  • awk

Data / config

  • sql
  • graphql
  • json
  • jsonc
  • yaml
  • toml
  • xml
  • ini
  • protobuf

Infra / DevOps

  • dockerfile
  • nginx
  • makefile
  • cmake
  • diff
  • patch

Mobile / native

  • swift
  • objective-c
  • dart
  • kotlin
  • java

Anything highlight.js supports works - including assembly, R, MATLAB, Julia, F#, Clojure, Lisp, Scheme, Smalltalk, Pascal, Fortran, COBOL and many more.

Markdown

Full GitHub-flavored Markdown.

Koala uses remark-gfm, so anything that renders on GitHub renders here. Plus a few extras for navigation and diagrams.

Feature Supported Notes
Headings (H1-H6)YesAnchor IDs auto-generated for in-doc links
Bold / italic / strikethroughYesGFM strikethrough included
Ordered & unordered listsYesNested to any depth
Task list checkboxesYesRendered as checkboxes in reader
TablesYesAlignment, header rows
ImagesYesRelative paths resolve against the file; click to zoom, hover Copy for the clipboard
LinksYesExternal + relative cross-file Markdown links
Auto-linked URLsYesVia GFM autolink
BlockquotesYesNested supported
Inline codeYesDistinct styling from block code
Fenced code blocksYesSyntax highlighted, line numbers, copy button
Horizontal rulesYes---
Heading anchors / ToCYesRendered as a clickable outline
Mermaid blocksYesRendered inline
D2 blocksYesRendered inline
LaTeX mathYesInline $…$, display $$…$$ and ```math, via KaTeX
Cross-file Markdown linksYesClick ./other.md to jump; other.md#heading lands on the heading
FootnotesYesGFM footnotes, linked both ways
Inline HTMLYesGitHub-sanitized: <details>, <kbd>, HTML tables; scripts stripped
Front matterYesYAML front matter shown as a metadata panel
JSON / CSV blocksYesFormat button for JSON, Table button for CSV / TSV
AsciiDocYes.adoc / .asciidoc rendered, header attributes as metadata. Diagram blocks not yet

Reading

Built to move through and present.

Feature Supported Notes
OutlineYesHeadings and the page's links, beside the document
Command paletteYes⌘K for files, headings and commands; ⌘P for files
HistoryYesBack / forward with ⌘[ ⌘]; repo-relative breadcrumbs
Page widthYesColumn, Wide (tables, diagrams, images and code grow past the text) or Full window, on ⌘1 ⌘2 ⌘3
Link hintsYesHover a link to see where it goes: web, Markdown, diagram, image, file or this page
Reader zoomYes⌘ / Ctrl + + − 0, or a trackpad pinch; keeps your place
Find in documentYes⌘F
Light / dark themesYesRestyle the rendered document too
Recent filesYesSidebar and File menu

Embeds and linked files

Reference a file, see the file.

Feature Supported Notes
Embed a diagram or pageYes![t](x.d2), .mmd, .html drawn in place, re-read when you return; HTML sandboxed, scripts off
Link to a diagram, image or HTMLYesOpens as its own page with Back; ⌥-click for a popup
Link to other filesYesText and code open read-only; anything else is revealed in Finder
Zoom viewerYesClick a diagram or image: fit, zoom at the pointer, pan
Draw on diagrams and imagesYesPen, highlighter, arrow, box, text; saves name.annotated.svg or a PNG
CopyYesDiagram source, or an image as PNG

Writing and import

Edit in place, bring documents in.

Feature Supported Notes
EditorYesAuto-save (or ⌘S), word wrap, zoom
FormattingYes⌘B ⌘I ⌘E ⌘K and a + menu: lists, checklist, code block, headings, quote, dropdown, date
Paste rich textYesWeb pages, Google Docs and Word become Markdown, tables included
Drop imagesYesLink in place, or copy beside the document or into a folder
Import .docx / .odtYesImages extracted, internal links kept

Export

Share the rendered output.

When you need to hand a doc to someone who doesn’t have Koala, export it.

Format What you get Best for
HTML The rendered document with all styling. Local images are not included yet; remote image links still load Sharing, archiving, posting on an intranet
PDF Image-based PDF of the rendered page Email, formal handover, printing
Open in browser Rendered HTML opens in your default browser (same image limit as HTML) Quick preview, browser-native Print -> Save as PDF
SVG / PNG One diagram, from its hover toolbar Slides, tickets, chat
Git link Forge URL to the file, pinned to the current commit Pointing a reviewer at the exact version

Open any Markdown folder and see for yourself.

Download Koala free during early access. Drop a folder in and every capability above works out of the box.

Download Koala free