Skip to content
/ Shiba Public

Simple, performant, and keyboard-centric markdown live preview app

License

Notifications You must be signed in to change notification settings

rhysd/Shiba

Repository files navigation

icon Shiba

CI dogs respected crates.io

Warning

Shiba v2 is a work in progress

Shiba is a simple Markdown preview application to be used with your favorite text editor. It is designed for simplicity, performance, keyboard-friendliness.

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
  • Cross platform; macOS, Windows, Linux are supported
  • Customizable with a YAML config file (color theme, keyboard shortcuts, custom CSS, ...)
  • Dogs are respected 🐕

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.