Hue MD v0.1.0

OPEN SOURCE · MIT LICENSE · COMMONMARK COMPATIBLE

Color and boxes for Markdown

Hue Markdown adds colored text and drawn boxes to Markdown. The source stays easy to read as plain text, for people and for AI. Edit the example below to see how it works.

Playground

demo.hue.md Add box

Hue Markdown

Build: passing · Coverage: 71% · Deploy: blocked

Highlight key phrases, combine text and background, or reach for an exact hex color when the palette is not enough. Normal prose like {a: 1} or {key: value} stays untouched.

Effortless Boxes

Start with +-- followed by info, ok, note, warn, or ! Every | line automatically starts on a new line Close with +-- — no right border or alignment needed

Full Markdown Inside

Boxes support bold, italics, inline code, and colored spans. Everything works out of the box across Web, CLI, VS Code, and Notepad++.

GitHub Ready

Run hue-md downgrade to convert Hue boxes into native GitHub Alerts ([!NOTE], [!TIP], [!IMPORTANT], [!WARNING], [!CAUTION]).

Heads Up

Public API endpoints are rate-limited to 100 requests/min. Cache responses locally before deploying to production.

Never Commit Secrets

Keep .env files out of git.

  • Add .env to .gitignore
  • Rotate any key that leaked immediately

Install

Plugins marked “Early version” have automated tests only. Feedback is welcome.

Editors

  • VS Code Also Cursor and Windsurf

    Search for “Hue MD” in Extensions. Adds a live preview, editor colors and box snippets.

  • Notepad++ Windows x64

    Download the zip and run install.ps1. Press Ctrl+Shift+H for the live preview.

  • Obsidian Early version

    Shows Hue colors and boxes in your vault. Install steps are in the zip.

  • Neovim Early version

    Editor colors and a :HueBox command. Install steps are in the zip.

  • Sublime Text and Emacs Early version

    Box snippets for Sublime Text and hue-md-mode.el for Emacs.

Command line and code

  • npm

    Terminal viewer, GitHub downgrade, HTML export and the markdown-it plugin.

    npm install -g hue-md
  • Stylesheet

    Light and dark Hue colors for your own website.

Browser

  • Userscript Early version

    Shows Hue on github.com. Install it with Tampermonkey or Violentmonkey.

  • Chrome and Edge Early version

    The same as the userscript, as an extension. Load the unzipped folder in developer mode.

Support Hue MD

Hue MD is free and open source. If it is useful to you, you can support the work.