Markdown Note

ComfyUI's built-in Note node is a plain text box, and after the fifth time you drag a workflow back out of a saved PNG and squint at a wall of raw text, you start wanting something better. Markdown Note [Eclipse] is that something: a socketless annotation node from the ComfyUI_Eclipse pack that renders your notes as Markdown - headers, bold, lists, code, the works - right on the canvas.

It's a pure sticky note for humans. It stores text in the workflow JSON, displays it, and gets out of your way. Nothing about it touches the actual generation.

How it works

The name hides a pleasantly clean implementation. In the Python schema the node has exactly one input - text, a multiline string with the author's own tooltip: "Markdown annotation text stored with the workflow." It has no outputs, and it's socketless, so there's never a wire dangling off it. The execute method is basically a formality: the frontend registers the node as virtual, which means ComfyUI skips it during queue execution entirely. It won't eat VRAM, slow your run, or error out mid-batch. It's a dead end by design - that's the whole point.

All the real work happens in the browser. The node's JavaScript replaces the default widget with a scrollable preview that renders Markdown through ComfyUI's own markdown renderer, and a hidden editor underneath. Double-click the note to start editing, click away and it re-renders. Scroll with your mouse wheel over the note and it scrolls the note, not the whole canvas - a small detail that every other annotation widget gets wrong. If the renderer isn't available (ancient ComfyUI), it degrades to plain pre-wrapped text instead of throwing.

One nice touch: Eclipse colors it like a classic note - yellow - so it reads as documentation even in a crowded graph. Drag the corner to resize; it defaults to 320×220 with an 80px floor.

What you actually set

One field. That's it.

• text - the note content, typed in Markdown. Newlines, ## headers, - lists, backtick code, **bold** all render in the preview.

Because the text serializes into the workflow, your notes ride along when you save an image with the workflow embedded - which matters more than it sounds. ComfyUI culture runs on "workflow included" images, and a shared workflow with an actual explanation of what each section does is worth ten screenshots.

Installing it

You install the whole pack to get the one node. Through ComfyUI Manager, search ComfyUI_Eclipse (or "Eclipse") and install; or clone it by hand:

cd ComfyUI/custom_nodes
git clone https://github.com/r-vage/ComfyUI_Eclipse

Then restart ComfyUI. The pack's requirements.txt lists torch, numpy, Pillow, opencv-python and friends - but those serve the image/video nodes. This note needs none of them, since it's frontend-only. In the node search, type "Markdown" and pick the one under 🌒 Eclipse / Text; other packs ship their own note nodes, so mind the category.

Common gotchas

• Don't wire it to anything. No outputs, no effect on the run. If you expect it to influence the image, you're using the wrong tool - that's what the Eclipse pipe nodes are for.
• Markdown showing as raw text? Update ComfyUI; the preview depends on the core markdown renderer, and the fallback is plain text.
• The text won't render for people without the pack. Open a shared workflow missing the node and ComfyUI shows a placeholder, note content and all. If your audience isn't on Eclipse, ComfyUI's built-in plain Note travels better - this one is for your own organized workflows.

Note this is ComfyUI_Eclipse v4.0.0-era code; older "RvTools" workflows predate it and need the pack's migration tool.