Skip to content

Releases: junkdog/ada-md

fuzz corpus

fuzz corpus Pre-release
Pre-release

Choose a tag to compare

@junkdog junkdog released this 29 Oct 17:26
84a7c9a

seed corpora for .github/workflows/fuzz.yml

ada 1.0.0

Choose a tag to compare

@github-actions github-actions released this 27 Oct 19:03
283ad89

ada 1.0: the fastest terminal markdown viewer, for one note or a whole vault. Now on crates.io.

ada showing a note with a seven-column table of durations and costs, and its status line

Ada's record of shenanigans, as ada shows it. s sorts the table by any column, and "Took" and "Damage" sort by what 2h 15m and €35 are worth, not as text. Narrow the terminal and the table turns into cards, one per row.

What's in it

  • Tables that know their units. s sorts by any column, and 350 µs, 1m 30s and €420 sort as the values they are. A table too wide for the terminal turns into cards.
  • Mermaid drawn as text. Sequence diagrams, flowcharts, state diagrams, class diagrams and gantt charts, fitted to the width and colored by the theme, in the pager and in --print.
  • Wiki links that survive moves. A [[link]] finds its note by name anywhere in the vault, as Obsidian does.
  • Search that sees through markup. A regex foo bar finds **foo** _bar_.
  • One previewer for fzf. Notes, code, logs, JSON and images at the pane's size, standing in for both bat and kitten icat.
  • Also: inline images over kitty, sixel or iTerm2, a git gutter, live reload, callouts and footnotes, mouse support, fourteen themes and your own, remappable keys, and a settings popup (F2).

It's measured against nine other terminal markdown viewers and bat, on wall time, CPU and memory: the charts.

New since rc.1

  • Mermaid class diagrams, and .mmd and .mermaid files, or a diagram piped in, open as the drawing.
  • Static musl binaries for x86_64 and aarch64 Linux: they run on Alpine and any other Linux.
  • --code-wrap on|off, and fzf previews cut long code lines at the pane's edge instead of wrapping them.
  • After a jump, where it landed stays tinted until the next key.
  • Documents past 65,535 columns or entries, and nesting 10,000 deep, are held in full.
  • A link wrapped inside a word without a space is listed, and rows under a sticky table header no longer take the link focus.
  • Less work per frame when redrawing.

The full list is in the changelog.

Install

From crates.io, with Rust 1.88 or newer and a C compiler:

cargo install --locked ada-md

Or a prebuilt binary, for Linux (x86_64, aarch64) and macOS (Apple silicon, Intel):

v=1.0.0 t=x86_64-unknown-linux-gnu
curl -L https://github.com/junkdog/ada-md/releases/download/v$v/ada-$v-$t.tar.gz | tar xz
install -m 755 ada-$v-$t/ada ~/.local/bin/

The gnu binaries need glibc 2.34 or newer. The musl ones are static and run on any Linux, Alpine included, but print large files in up to 1.4× the time. The macOS binaries aren't signed. If the archive came through a browser, clear the quarantine flag first: xattr -d com.apple.quarantine ada. SHA256SUMS lists the checksums of the archives.

Windows is mostly untested: ada builds and runs there, but doesn't follow Windows' conventions yet (the config is read from $XDG_CONFIG_HOME or $HOME/.config, links open with xdg-open). The README lists what's missing. Proper support is planned for 1.1.

Known issues

Please report anything odd in issues. --record turns a session into a file you can attach.

ada 1.0.0-rc.3

ada 1.0.0-rc.3 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 25 Oct 21:58
ac74c85

The third release candidate of ada 1.0: the fastest terminal markdown viewer, for one note or a whole vault.

This is a pre-release. If nothing turns up, the same code ships as 1.0.0. Please report anything odd in
issues. --record turns a session into a file you can attach.

Features

  • (cli) Add --code-wrap on|off, and let fzf previews cut code at the pane's edge
  • (diagram) Draw mermaid class diagrams as text, fitted to the width and styled by the theme
  • (ui) Tint where a jump landed until the next key

Fixes

  • (app) List a link wrapped inside a word without a space
  • (ui) Keep the outline popup's size from wrapping past 65,535 headings or columns
  • Hold documents past 65,535 columns or entries, and nesting 10,000 deep.

ada 1.0.0-rc.2

ada 1.0.0-rc.2 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 24 Oct 17:36
7d3cee2

The second release candidate of ada 1.0: the fastest terminal markdown viewer, for one note or a whole vault.

This is a pre-release. If nothing turns up, the same code ships as 1.0.0. Please report anything odd in
issues. --record turns a session into a file you can attach.

Features

  • (filetype) Draw .mmd/.mermaid files and piped mermaid diagrams
  • (release) Ship static musl binaries for x86_64 and aarch64 Linux

Fixes

  • (nav) Treat rows under a sticky table header as off screen when focusing links
  • (order) Read the traced build's link map from its target directory
  • (order) Read link maps as bytes and measure peak RSS through time
  • (order) Skip AArch64 mapping symbols in lld maps
  • (release) Compile aarch64 musl atomics inline for jemalloc

Performance

  • (grid) Compare plain rows as bytes and give styles the cell's color encoding
  • (grid) Erase blanks on the theme's background instead of writing spaces

ada 1.0.0-rc.1

ada 1.0.0-rc.1 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 23 Oct 18:41
a731097

The first release candidate of ada 1.0: the fastest terminal markdown viewer, for one note or a whole vault.

This is a pre-release. If nothing turns up, the same code ships as 1.0.0. Please report anything odd in
issues. --record turns a session into a file you can attach.

What's in it

  • Tables that know their units. s sorts by any column, and 350 µs, 1m 30s and €420 sort as the
    values they are. A table too wide for the terminal turns into cards.
  • Mermaid drawn as text. Sequence diagrams, flowcharts, state diagrams and gantt charts, fitted to the
    width and colored by the theme, in the pager and in --print.
  • Wiki links that survive moves. A [[link]] finds its note by name anywhere in the vault, as Obsidian
    does.
  • Search that sees through markup. A regex foo bar finds **foo** _bar_.
  • One previewer for fzf. Notes, code, logs, JSON and images at the pane's size, standing in for both
    bat and kitten icat.
  • Also: inline images over kitty, sixel or iTerm2, a git gutter, live reload, callouts and footnotes, mouse
    support, fourteen themes and your own, remappable keys, and a settings popup (F2).

It's measured against nine other terminal markdown viewers and bat, on wall time, CPU and memory:
the charts.

Install

Prebuilt binaries for Linux (x86_64, aarch64; glibc 2.34 or newer) and macOS (Apple silicon, Intel):

v=1.0.0-rc.1 t=x86_64-unknown-linux-gnu
curl -L https://github.com/junkdog/ada-md/releases/download/v$v/ada-$v-$t.tar.gz | tar xz
install -m 755 ada-$v-$t/ada ~/.local/bin/

The macOS binaries aren't signed. If the archive came through a browser, clear the quarantine flag first:
xattr -d com.apple.quarantine ada. SHA256SUMS lists the checksums of the archives.

Or build it with Rust 1.88 or newer and a C compiler. Do that on Alpine and other musl distributions too, since the
Linux binaries need glibc:

cargo install --locked --git https://github.com/junkdog/ada-md --tag v1.0.0-rc.1 ada-md

Windows is mostly untested: ada builds and runs there, but doesn't follow Windows' conventions yet (the config is
read from $XDG_CONFIG_HOME or $HOME/.config, links open with xdg-open). The README lists what's missing. Proper
support is planned for 1.1.

Known issues