README.md

July 24, 2026 · View on GitHub

██╗      ██████╗ ██████╗ ███████╗███╗   ███╗
██║     ██╔═══██╗██╔══██╗██╔════╝████╗ ████║
██║     ██║   ██║██████╔╝█████╗  ██╔████╔██║
██║     ██║   ██║██╔══██╗██╔══╝  ██║╚██╔╝██║
███████╗╚██████╔╝██║  ██║███████╗██║ ╚═╝ ██║
╚══════╝ ╚═════╝ ╚═╝  ╚═╝╚══════╝╚═╝     ╚═╝

License: MIT zmax plugin

[LOREM-IPSUM AT THE CURSOR — COMPILED]

"lorem — one word, and the placeholder text is in the buffer."

[NATIVE ZMAX PLUGIN]

:lorem [n] inserts n paragraphs of lorem-ipsum placeholder text at the cursor — as a native zmax plugin: a compiled Rust cdylib loaded at runtime over zmax's stable C ABI, no editor recompile. Zero dependencies.

zmax · zmax-native · docs

Table of Contents

[0x00] OVERVIEW

:lorem       → one paragraph
:lorem 3     → three paragraphs, blank-line separated

[0x01] INSTALL

:zmax-native add MenkeTechnologies/zmax-native-lorem

zmax-native, zmax's package manager, clones the repo, runs cargo build --release, installs the cdylib into the content-addressed store under ~/.zmax/pkg/ (SHA-256 pinned), and dlopens it — by mmap, so the loader pages the library in. To self-install on first launch and load zero-network after, add one line to ~/.zmax/init.el (Emacs Lisp) or ~/.zmax/init.vim:

(editor-command "zmax-native" "get" "MenkeTechnologies/zmax-native-lorem")

Manual build

cargo build --release

Then, in zmax:

:zmax-native load ./target/release/libzmax_native_lorem.dylib   # .so on Linux

[0x02] USAGE

:lorem inserts one paragraph at the cursor; :lorem N inserts N paragraphs (clamped to 1–50), separated by blank lines. The insertion is a single undo step.

[0x03] HOW IT WORKS

The plugin registers one typable command, lorem, through the zmax-native SDK. It parses an optional paragraph count from its argument (default 1, clamped 1–50), joins that many copies of a fixed lorem-ipsum paragraph with blank lines, and inserts the result with the host insert_text callback (undoable as one transaction). No dependencies.

[0xFF] LICENSE

MIT. Built against the zmax-native plugin SDK. See LICENSE.