kais-radwan

kais-radwan / ascii-mermaid

Public

Neovim plugin that renders Mermaid diagrams as inline ASCII art using virtual text

mermaid neovim neovim-plugin
32
3
100% credibility
Found Feb 17, 2026 at 31 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

Neovim extension that automatically renders Mermaid diagrams from markdown code blocks as inline ASCII or Unicode text art.

How It Works

1
📝 Open your notes

You fire up your simple text editor and open a file full of ideas with diagram sketches.

2
🧩 Drop in a diagram sketch

You paste a plain text description of a flowchart or chart inside a special marked section.

3
✨ Watch the magic happen

Right away, the diagram transforms into clear, pretty text artwork drawn with lines and boxes.

4
🔧 Tweak the look

Switch between plain letters or elegant symbols, or choose how the art overlays your sketch.

5
👆 Edit with ease

As you move your cursor, the art smartly steps aside so you can tweak your original words.

🎉 Live diagrams in notes

Your ideas now flow with visible charts that update instantly, keeping everything in one cozy spot.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 31 to 32 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is ascii-mermaid?

Neovim plugin that detects Mermaid code blocks in markdown files and renders them as inline ASCII art or Unicode box drawings using virtual text overlays. Write ```mermaid diagrams for flowcharts, sequences, class diagrams, ER, Gantt, pie, or timelines, and see mermaid ascii output right in your editor—no browser tabs needed. Pairs Lua for seamless neovim github integration with TypeScript-powered async rendering via Node.

Why is it gaining traction?

Delivers mermaid diagram to ascii instantly on BufEnter for .md files, with modes like replace (overlays code, hides on cursor enter), inline (below blocks), hybrid (auto-switches by size), or readonly. Toggle via :MermaidRender, switch styles with :MermaidStyle ascii/unicode, or force refresh with :MermaidRenderAll. Beats mermaid vs ascii tools by staying inline, beating browser renders for quick edits in neovim github copilot chat sessions.

Who should use this?

Neovim devs writing markdown docs with Mermaid—API flows, DB schemas, project timelines—in READMEs, wikis, or notes. Ideal for neovim plugin development folks tweaking neovim github config, neovim github copilot agent mode users diagramming alongside code, or anyone in neovim plugin directory hunting neovim github plugin gems for docs workflows.

Verdict

Solid pick for Neovim markdown power users craving mermaid js ascii art without leaving the editor; install via your neovim github releases manager and test in a .md file. 31 stars and 1.0% credibility signal early days—docs are clear, tests run via Makefile—but watch neovim plugin guide for maturity as it grows.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.