Skip to content

PerMark v0.5.8

Choose a tag to compare

@github-actions github-actions released this 18 Oct 19:33

PerMark is a free, open-source Markdown app: read what your AI writes, write what it reads. It opens any .md
file as a clean page, keeps notes that save themselves, and turns a project folder into an IDE for following your
agents. It works with any AI tool, or none: it only relies on your files and git.

Draw a PlantUML diagram in the page, start a new file from a folder, and keep a wide block inside the pane.

Added

  • PlantUML diagrams. A plantuml or puml block draws in the reading view, the same way a Mermaid block does. In Visual the source stays, with a live preview beside it. No Java and no PlantUML server. A diagram that would fetch a file does not run.
  • New file. Right-click a folder, or the project name, and choose New Markdown file or New text file. The same two entries are in the Projects menu and in the Explorer menu. A text file opens in Source. On Windows, right-click a folder or its background and choose New Markdown file with PerMark: the folder opens with untitled.md in it.
  • A note's path. From a note or a loose file, Copy path puts its path on the clipboard, and Show in file manager selects the file. Copy stays available while the path is known. A file that is missing is not shown.

Fixed

  • Heading shortcuts in Visual. Ctrl+Alt with a number is the AltGr key on Windows, so those chords typed a character instead of changing the block. Paragraph and headings 1 to 6 are Ctrl+Shift+0 through Ctrl+Shift+6.
  • A wide block stays inside the pane. Prose wraps in the column. A long table row or a diagram line scrolls inside its block, instead of growing the page past the window.

Install

Platform Download
Windows the -setup.exe installer (or the .msi)
macOS the universal .dmg (Apple silicon and Intel)
Linux the .AppImage, .deb or .rpm

PerMark updates itself: when a new version is out, it offers a one-click "Restart to update".

The app is not code-signed yet

The installers are unsigned, so your system warns you the first time. They are built by GitHub Actions
from the tagged commit, and the in-app updates are verified with a signature.

Windows (SmartScreen). If you see "Windows protected your PC", click More info, then Run anyway.

macOS (Gatekeeper). If macOS says it can't verify PerMark, open System Settings, Privacy & Security,
scroll to the Security section and click Open Anyway. On older macOS versions you can right-click the
app and choose Open instead. From a terminal: xattr -dr com.apple.quarantine /Applications/PerMark.app.

Linux. Make the AppImage executable (chmod +x PerMark_*.AppImage) and run it, or install the .deb / .rpm.