xonecas.io

yoctomarkdown

A small, fast, Bun-native Markdown highlighter for terminal output.

post-AI small cli bun

33 commits · 2026-03-15 to 2026-04-04 · 21 files

xonecaschore: bump version to 0.1.02b648782026-04-04
▸ .agents/ 2026-03-15
▸ .husky/ 2026-03-15
▸ examples/ 2026-04-04
▸ src/ 2026-04-04
▸ tests/ 2026-04-04
· .gitignore 2026-03-15
· .prettierrc 2026-03-15
· AGENTS.md 2026-03-16
· biome.json 2026-03-15
· bun.lock 2026-03-16
· knip.json 2026-03-16
· package.json 2026-04-04
· README.md 2026-03-15
· spec.md 2026-04-04
· TODO.md 2026-04-04
· tsconfig.json 2026-03-15

README.md

yoctomarkdown

A small, fast, Bun-native Markdown highlighter for terminal output.

yoctomarkdown reads Markdown and writes ANSI-colored text to stdout or returns it as a string. It focuses on simple, fast, incremental rendering for CLI and programmatic use, supporting a practical subset of Markdown specifically for terminal display.

Features

  • Incremental processing: Stream chunks of Markdown without buffering the entire document.
  • Terminal optimized: Styles headings, code blocks, lists, and more using yoctocolors.
  • Flexible: Use it as a library (highlightSync, createHighlighter) or as a CLI tool.
  • Fast: Built for the Bun runtime.

Installation

npm package

bun add yoctomarkdown

Usage

CLI

Run via the command line:

# Read from a file
yoctomarkdown README.md

# Read from stdin
cat README.md | yoctomarkdown

Options:

  • -t, --theme <name>: Theme to use (16, 256, truecolor, minimal, none). Defaults to 16.
  • -w, --wrap <n|auto|0>: Word wrapping length. Defaults to auto (terminal width).
  • -h, --help: Show help.

Library API

You can use yoctomarkdown programmatically in two ways: synchronously for complete strings, or incrementally via the highlighter.

Synchronous

import { highlightSync } from "yoctomarkdown";

const markdown = "# Hello World\n\nThis is **bold** text.";
const output = highlightSync(markdown, { theme: "truecolor" });
console.log(output);

Streaming / Incremental

import { createHighlighter } from "yoctomarkdown";

const highlighter = createHighlighter({ theme: "16" });

process.stdout.write(highlighter.write("# Chunk 1\n"));
process.stdout.write(highlighter.write("Some *italic* text in Chunk 2.\n"));
process.stdout.write(highlighter.end());

Options

interface Options {
  theme?: "16" | "256" | "truecolor" | "minimal" | "none" | Theme; // default: "16"
  tabWidth?: number; // default: 2
  wordWrap?: number | "auto" | 0; // default: "auto"
  yieldEvery?: number; // default: 1000
}

Supported Markdown

  • Headings (#, ##, ###)
  • Bold (**text**) and Italic (*text*)
  • Inline code ( \code` ) and Fenced code blocks ( ``` `)
  • Links ([text](url))
  • Lists (-, *, 1.)
  • Blockquotes (>)
  • Horizontal rules (---)

Unsupported Markdown elements are preserved as plain text.

Scripts

To contribute or develop locally, the following commands are available:

  • bun run check: Runs formatting, linting, typechecking, and duplication checks.
  • bun run format: Formats code using Prettier.
  • bun test: Runs tests.