Skip to content
 
 

Repository files navigation

reMark

A lightweight Markdown and HTML editor for Linux Mint with live preview, multiple tabs, accurate scroll synchronization, and click-to-source navigation.

This project is a maintained fork of Remarkable, modernized for Linux Mint 22.x and Ubuntu 24.04.

Highlights

  • Multiple document tabs with independent editor and preview state
  • Recent Files menu
  • Live Markdown and full-document HTML preview
  • Accurate editor-to-preview scroll synchronization
  • Click any rendered element to locate its source
  • Line-level navigation inside fenced code and <pre> blocks
  • Independent editor and preview zoom controls
  • GitHub Flavored Markdown
  • Syntax highlighting
  • MathJax support
  • HTML and PDF export
  • Custom CSS and style support
  • Single-instance file opening from the command line or file manager
  • Light and dark theme support
  • High-DPI display support
  • High-contrast, e-ink-friendly application artwork
  • Native Debian package with no Snap dependency

Supported Systems

Tested on:

  • Linux Mint 22.x
  • Ubuntu 24.04 Noble
  • Cinnamon light and dark themes
  • 100% and 200% display scaling

The application uses GTK 3, GtkSourceView 3, WebKitGTK 4.1, and Python 3.

Installation

Download remarkable_1.97_all.deb from the latest GitHub release.

Install it with:

sudo apt install ./remarkable_1.97_all.deb

Remove it with:

sudo apt remove remarkable

Build From Source

Install the required packages:

sudo apt update
sudo apt install python3 python3-bs4 python3-gi python3-lxml python3-markdown \
  python3-pdfkit gir1.2-gtk-3.0 gir1.2-gtksource-3.0 \
  gir1.2-webkit2-4.1 wkhtmltopdf

Clone the repository and build the package:

git clone https://github.com/datawife/reMark.git
cd reMark
SOURCE_DATE_EPOCH=1753880400 ./debian/build-deb.sh

The package will be created at:

dist/remarkable_1.97_all.deb

Install the locally built package:

sudo apt install ./dist/remarkable_1.97_all.deb

Preview Navigation

reMark maps visible rendered content directly to its source location.

  • Scrolling the editor follows the corresponding preview content.
  • Clicking the preview moves the editor to the relevant source line.
  • Nonvisual HTML such as <head>, scripts, styles, templates, comments, and metadata does not distort synchronization.
  • Large code blocks support line-level navigation.
  • Mapping is rebuilt when content, images, fonts, window size, or rendered geometry changes.

Tabs and Recent Files

Each tab maintains its own:

  • Document
  • Cursor and selection
  • Editor scroll position
  • Preview scroll position
  • Render state
  • Unsaved-change state

Recently opened files are stored in:

~/.config/remarkable/settings.json

The exact location follows $XDG_CONFIG_HOME when it is defined.

Zoom Controls

Editor and preview zoom are independent.

  • The left-side text-size controls change source-editor text only.
  • The right-side magnifying-glass controls change preview zoom only.
  • Editor zoom applies consistently across tabs.
  • New tabs inherit the current editor zoom.
  • The selected editor font family and style are preserved.
  • Zoom preferences persist between sessions.

Keyboard Shortcuts

Action Shortcut
New File Ctrl+N
Open File Ctrl+O
Save File Ctrl+S
Save File As Ctrl+Shift+S
Quit Ctrl+Q
Undo Ctrl+Z
Redo Ctrl+Shift+Z
Cut Ctrl+X
Copy Ctrl+C
Paste Ctrl+V
Find Ctrl+F
Bold Ctrl+B
Italic Ctrl+I
Strikethrough Ctrl+D
Highlight Ctrl+Shift+H
Heading 1 Ctrl+1
Heading 2 Ctrl+2
Heading 3 Ctrl+3
Heading 4 Ctrl+4
Insert Link Ctrl+L
Insert Image Ctrl+Shift+I
Insert Table Ctrl+Shift+T
Insert Timestamp Ctrl+T
Insert Horizontal Rule Ctrl+H
Export HTML Ctrl+Shift+E
Export PDF Ctrl+E
Fullscreen F11
Preview Zoom In Ctrl+Plus
Preview Zoom Out Ctrl+Minus

Testing

The 1.97 release passed:

  • 28 automated tests
  • Real WebKitGTK geometry integration tests
  • Preview click-feedback regression tests
  • Tab, settings, zoom, accessibility, and storage tests
  • Light and dark theme tests
  • 100% and 200% display-scaling tests
  • Continuous and reduced-level grayscale tests
  • One-bit threshold and Floyd–Steinberg e-ink simulations
  • Reproducible Debian package builds

Project Scope

reMark currently targets desktop Linux. Android is not part of the project scope.

Window borders and title-bar controls are supplied by the active desktop theme. The application does not replace or recolor the system window controls.

Contributing

Bug reports and pull requests are welcome through the GitHub issue tracker.

When reporting a preview synchronization problem, include:

  • Whether the document is Markdown or full HTML
  • A minimal sample document when possible
  • Your Linux distribution and desktop environment
  • Whether display scaling is enabled

Synchronization diagnostics can be enabled with:

REMARKABLE_SYNC_DEBUG=1 remarkable

Credits

reMark is based on the original Remarkable Markdown editor.

The original project, its contributors, and its artwork provided the foundation for this maintained Linux Mint–focused fork.

License

See the repository’s license file for licensing terms.

About

reworking Remarkable - Markdown Editor for Linux http://remarkableapp.github.io

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages