Skip to content
 
 

Latest commit

 

History

56 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

omaths

omaths is a derivative of omawrite made to enter LaTeX maths.

It is still a dead-simple Markdown writing app built with Qt Quick and C++ that automatically follows system dark/light mode. Formulas are written in the document as LaTeX and rendered inline with a bundled MathJax tex-svg runtime.

screenshot-2026-06-23_15-24-08 screenshot-2026-06-23_15-23-23

Install

Build and install the omaths package locally with ./bin/install (Arch, via makepkg), or build the binary only with ./bin/build.

Shortcuts

  • Ctrl+S saves. Unsaved documents use the XDG desktop portal file picker.
  • Ctrl+Shift+S saves as.
  • Ctrl+O opens a Markdown file through the portal picker.
  • Ctrl+P opens the system print dialog.
  • Ctrl+N opens a new omaths window.
  • Ctrl+Z, Ctrl+Shift+Z, and Ctrl+Y handle undo and redo.
  • Super+F toggles fullscreen. Qt maps this key as Meta+F.
  • Ctrl+F searches the document. Use Enter or Ctrl+G for the next match and Shift+Enter for the previous match.
  • Ctrl+H opens find and replace.
  • Ctrl+B, Ctrl+I, and Ctrl+K insert bold, italic, and link Markdown.
  • Ctrl+M toggles math render mode (rendered formulas vs LaTeX source).
  • Ctrl+/ shows the keyboard shortcut reference (Ctrl+? is also accepted as a compatibility alias).

Unsaved drafts are recovered after an abnormal exit. omaths also watches open files and warns before an external change can replace local work.

Text follows the desktop text size — omarchy display text size, or GNOME's text-scaling-factor — and re-flows without a restart. The default of 12px leaves omaths at the size it is designed around; larger and smaller sizes scale from there.

Requirements

  • Qt 6: qt6-base, qt6-declarative, qt6-quickcontrols2, qt6-svg
  • xdg-desktop-portal and a portal backend

Supported math delimiters are:

  • Inline: $...$, \(...\)
  • Display: $$...$$, \[...\]

Escaped dollars (\$) are ignored, and formulas inside inline/fenced code are not parsed as math. Inline $...$ follows Pandoc's spacing rules: no space after the opening $ or before the closing $, and a closing $ followed by a digit is treated as currency rather than math, so $n$, works and $5 and $6 does not. By default (math/SaveFormulaAsSvg=true in QSettings), generated SVG is cached under a .svg-cache/ directory next to the current document when possible.

Use Ctrl+M to switch between rendered formulas and editable LaTeX source.

The iA Writer Mono font is bundled under the SIL Open Font License 1.1; see fonts/OFL.txt. The font is copyright Information Architects Inc. and based on IBM Plex, copyright IBM Corp.

About

The essence of writing

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages