Sashmark / Help

Sashmark is in development. Nothing has been released yet, and there is no public build. These pages describe the development build. See the roadmap for what is still planned.

Mac, Windows, and Linux

The Windows SmartScreen warning, opening a Mac build that is not signed yet, how Mac, Windows and Linux differ, and every way to quit on each.

Windows: the SmartScreen warning

Windows builds of Sashmark are not code-signed yet. If that is still true at release, Windows may show "Windows protected your PC" (SmartScreen) when you run the installer. This is expected for a new app that is not signed: click More info, then Run anyway.

Mac: opening a build that is not signed yet

Mac builds of Sashmark are not signed or notarized by Apple yet. The first time you open Sashmark, macOS may say it can't check the app for malicious software and won't open it. To open it once:

  1. In Finder, open your Applications folder, Control-click (or right-click) Sashmark, and choose Open. If the box that appears has an Open button, click it.
  2. If there is no Open button, choose Done, then open System Settings > Privacy & Security, scroll down to the message about Sashmark, and click Open Anyway. Enter your Mac password if asked.

After that, Sashmark opens normally.

Differences between systems

This is how current development builds work; it may change before release.

Mac Windows Linux
Shortcut key Cmd Ctrl Ctrl
Menus Sashmark, File, Edit, View, Window, Help Help File, Edit, View, Window, Help
Zoom Cmd+= / Cmd++, Cmd+-, Cmd+0, and the View menu (macOS 11 or later) Ctrl+= / Ctrl++, Ctrl+-, Ctrl+0 (work without a menu) Ctrl+= / Ctrl++, Ctrl+-, Ctrl+0, and the View menu
Open and Close Tab shortcuts Cmd+O, Cmd+W Ctrl+O, Ctrl+W (work without a menu) Ctrl+O, Ctrl+W
New Window and Close Window shortcuts Cmd+N, Cmd+Shift+W (File menu) Ctrl+N, Ctrl+Shift+W (work without a menu) Ctrl+N, Ctrl+Shift+W (File menu)
Switching windows Window menu, Cmd+` Alt+Tab, taskbar Window menu, your desktop's switcher
sashmark command Yes, from the Sashmark menu Yes, from the Help menu Yes, from the Help menu
Admin password for the command, if needed Mac password prompt Never needed (adds its folder to your user PATH) System password prompt (pkexec)
Double-click a Markdown file to open it Yes, when Sashmark is the app for Markdown files Not covered here yet Not covered here yet

Everything else works the same on all three: opening files, drag and drop, the Open a file button, tabs, the tab-switching shortcuts, and the boxes that ask about unsaved edits.

Linux: app menus

Linux app menus list Sashmark in the Office category. The app's executable and icon use the name sashmark.

Remembered window on Linux

On Wayland, the desktop decides window placement and may ignore a window's remembered position, whether you have one window or several. The window size is still fitted to the available display. Native reopening and display changes have not yet been checked on any of the three systems; see Remembering your window.

Nested lists: what has been checked

Moving list items with Tab and Shift+Tab (see Nesting list items) has been checked this far:

  • Line endings. Automated tests on the saved bytes cover files with LF line endings and files with Windows-style CRLF line endings. Each kind keeps its own line endings, on the new lines too.
  • Real key presses. The Tab and Shift+Tab tests with real key presses ran in a test browser engine (WebKit, with no window), not in the app's own window on each system.

The app's own window on Mac, on Windows, and on Linux has not been checked for this yet. This page will say so when it has.

Quitting

On every system, closing the last window is the same as quitting, and quitting asks once for all windows (see Multiple windows). Closing windows one by one, for example from a taskbar group, is not a quit. Each of these asks about unsaved edits first (see Editing and saving a file), also when the window is minimized or hidden: Sashmark comes to the front.

Mac Windows Linux
Sashmark > Quit Sashmark, Cmd+Q, the window's close button The window's close button, Alt+F4 (Windows has no Quit menu item or Ctrl+Q) File > Quit, Ctrl+Q, the window's close button, Alt+F4 or your desktop's close

This build routes a Mac Quit from the Dock icon's menu, log out, restart or shut down through the same unsaved-edits choices as Cmd+Q. Dock dirty-edit decisions and the log out, restart and shut down round trips have not yet been checked in a real Mac app. Until they are checked, use Cmd+Q to finish Save all, Discard all, Review or Cancel before starting a system action.

On Mac and Linux, a normal request to close from another program or the system (for example the kill command, or a Linux log out or shut down that sends this request) asks about unsaved edits the same way Quit does, as long as Sashmark's window can still answer. So does Ctrl+C in a terminal that started Sashmark. Cancel keeps Sashmark open with your edits. A force quit (kill -9), a crash or a power loss is not covered: Sashmark cannot ask, and unsaved edits are lost.

In every box about unsaved edits, on all three systems: Cancel comes first and has the focus, Return and Escape pick Cancel, Tab and Shift+Tab move between the box's buttons only, and Return on another button you moved to picks that button.

View as Markdown