rhysd/Shiba

Simple, performant, and keyboard-centric Markdown browser

804

stars

1,371

commits

Rust

primary language

Jul 20, 2026

updated

desktop-app
markdown
preview

README

icon Shiba

CI dogs respected crates.io

[!WARNING] Shiba v2 is a work in progress

Shiba is a simple Markdown browser to preview documents with your favorite text editor. It is designed for simplicity, performance, keyboard-friendly navigations.

Screenshot of light/dark windows

Features:

  • GitHub-flavored Markdown support; Emojis, Table, Alerts, Math expressions with Mathjax, Diagrams with mermaid.js, ...
  • Watch the files or directories and automatically update the preview efficiently using OS-specific filesystem events (FSEvents, inotify, ...)
  • Automatically scroll to the last modified position
  • All features can be accessed via keyboard shortcuts (scroll the article, search text, jump to section, go forward/back history...). Type ? to know all shortcuts
  • Sections outline in side navigation bar highlighting the current section
  • Both CLI and GUI friendly; Available as a single binary executable as well as an installable desktop application
  • Performance critical part (parsing Markdown text, searching Markdown AST, calculating the last modified position, ...) and core application logic are written in Rust. Thin view logic is written in TypeScript & React and runs on platform-specific WebView
  • Multiple windows support to open multiple documents simultaneously
  • Cross platform; macOS, Windows, Linux are supported
  • Customizable with a YAML config file (color theme, keyboard shortcuts, custom CSS, ...)
  • Dogs are respected :dog2:

Documentation

All documentations are in the docs directory.

About v2

Shiba v2 is the complete rewrite of v1 using Rust and platform-specific WebView. For v1, please visit the v1 branch.

License

This software is distributed under the MIT license.

Contributors

rhysd

1,364 commits

garaemon

3 commits

Rqnsom

1 commits

rhysd/Shiba

Simple, performant, and keyboard-centric Markdown browser

804

stars

1,371

commits

Rust

primary language

Jul 20, 2026

updated

desktop-app
markdown
preview

README

icon Shiba

CI dogs respected crates.io

[!WARNING] Shiba v2 is a work in progress

Shiba is a simple Markdown browser to preview documents with your favorite text editor. It is designed for simplicity, performance, keyboard-friendly navigations.

Screenshot of light/dark windows

Features:

  • GitHub-flavored Markdown support; Emojis, Table, Alerts, Math expressions with Mathjax, Diagrams with mermaid.js, ...
  • Watch the files or directories and automatically update the preview efficiently using OS-specific filesystem events (FSEvents, inotify, ...)
  • Automatically scroll to the last modified position
  • All features can be accessed via keyboard shortcuts (scroll the article, search text, jump to section, go forward/back history...). Type ? to know all shortcuts
  • Sections outline in side navigation bar highlighting the current section
  • Both CLI and GUI friendly; Available as a single binary executable as well as an installable desktop application
  • Performance critical part (parsing Markdown text, searching Markdown AST, calculating the last modified position, ...) and core application logic are written in Rust. Thin view logic is written in TypeScript & React and runs on platform-specific WebView
  • Multiple windows support to open multiple documents simultaneously
  • Cross platform; macOS, Windows, Linux are supported
  • Customizable with a YAML config file (color theme, keyboard shortcuts, custom CSS, ...)
  • Dogs are respected :dog2:

Documentation

All documentations are in the docs directory.

About v2

Shiba v2 is the complete rewrite of v1 using Rust and platform-specific WebView. For v1, please visit the v1 branch.

License

This software is distributed under the MIT license.

Contributors

rhysd

1,364 commits

garaemon

3 commits

Rqnsom

1 commits

Languages

Rust

71.4%

TypeScript

23.6%

JavaScript

3.2%