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 |
|---|---|---|
| Mermaid | Flowchart | Top-down, left-right, branching |
| Sequence diagram | Actors, messages, loops, notes | |
| Class diagram | Inheritance, composition | |
| State diagram | State machines, transitions | |
| Entity-relationship | Schemas, cardinality | |
| User journey | Step-by-step flows | |
| Gantt chart | Schedules, milestones | |
| Pie chart | Proportional breakdowns | |
| Quadrant chart | 2x2 matrices | |
| Requirement diagram | Spec-style requirements | |
| Git graph | Branching, commits | |
| Mindmap | Hierarchical idea trees | |
| Timeline | Sequenced events | |
| Sankey | Flow / weight diagrams | |
| XY chart | Plots, scatter, bar | |
| Block diagram | Logical blocks | |
| Packet diagram | Byte/bit layouts | |
| Kanban | Boards | |
| Architecture | System architecture | |
| C4 | Context, container, component | |
| D2 | Flowchart | Layered, auto-layout |
| Sequence diagram | Lifelines, messages | |
| Class / shape graphs | Custom shapes, containers | |
| ER diagram | Tables and relationships | |
| Free-form graphs | Any 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) | Yes | Anchor IDs auto-generated for in-doc links |
| Bold / italic / strikethrough | Yes | GFM strikethrough included |
| Ordered & unordered lists | Yes | Nested to any depth |
| Task list checkboxes | Yes | Rendered as checkboxes in reader |
| Tables | Yes | Alignment, header rows |
| Images | Yes | Relative paths resolve against the file; click to zoom, hover Copy for the clipboard |
| Links | Yes | External + relative cross-file Markdown links |
| Auto-linked URLs | Yes | Via GFM autolink |
| Blockquotes | Yes | Nested supported |
| Inline code | Yes | Distinct styling from block code |
| Fenced code blocks | Yes | Syntax highlighted, line numbers, copy button |
| Horizontal rules | Yes | --- |
| Heading anchors / ToC | Yes | Rendered as a clickable outline |
| Mermaid blocks | Yes | Rendered inline |
| D2 blocks | Yes | Rendered inline |
| LaTeX math | Yes | Inline $…$, display $$…$$ and ```math, via KaTeX |
| Cross-file Markdown links | Yes | Click ./other.md to jump; other.md#heading lands on the heading |
| Footnotes | Yes | GFM footnotes, linked both ways |
| Inline HTML | Yes | GitHub-sanitized: <details>, <kbd>, HTML tables; scripts stripped |
| Front matter | Yes | YAML front matter shown as a metadata panel |
| JSON / CSV blocks | Yes | Format button for JSON, Table button for CSV / TSV |
| AsciiDoc | Yes | .adoc / .asciidoc rendered, header attributes as metadata. Diagram blocks not yet |
Reading
Built to move through and present.
| Feature | Supported | Notes |
|---|---|---|
| Outline | Yes | Headings and the page's links, beside the document |
| Command palette | Yes | ⌘K for files, headings and commands; ⌘P for files |
| History | Yes | Back / forward with ⌘[ ⌘]; repo-relative breadcrumbs |
| Page width | Yes | Column, Wide (tables, diagrams, images and code grow past the text) or Full window, on ⌘1 ⌘2 ⌘3 |
| Link hints | Yes | Hover a link to see where it goes: web, Markdown, diagram, image, file or this page |
| Reader zoom | Yes | ⌘ / Ctrl + + − 0, or a trackpad pinch; keeps your place |
| Find in document | Yes | ⌘F |
| Light / dark themes | Yes | Restyle the rendered document too |
| Recent files | Yes | Sidebar and File menu |
Embeds and linked files
Reference a file, see the file.
| Feature | Supported | Notes |
|---|---|---|
| Embed a diagram or page | Yes | , .mmd, .html drawn in place, re-read when you return; HTML sandboxed, scripts off |
| Link to a diagram, image or HTML | Yes | Opens as its own page with Back; ⌥-click for a popup |
| Link to other files | Yes | Text and code open read-only; anything else is revealed in Finder |
| Zoom viewer | Yes | Click a diagram or image: fit, zoom at the pointer, pan |
| Draw on diagrams and images | Yes | Pen, highlighter, arrow, box, text; saves name.annotated.svg or a PNG |
| Copy | Yes | Diagram source, or an image as PNG |
Writing and import
Edit in place, bring documents in.
| Feature | Supported | Notes |
|---|---|---|
| Editor | Yes | Auto-save (or ⌘S), word wrap, zoom |
| Formatting | Yes | ⌘B ⌘I ⌘E ⌘K and a + menu: lists, checklist, code block, headings, quote, dropdown, date |
| Paste rich text | Yes | Web pages, Google Docs and Word become Markdown, tables included |
| Drop images | Yes | Link in place, or copy beside the document or into a folder |
| Import .docx / .odt | Yes | Images 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 |
| 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