Checkpoint Name List

Pick a checkpoint from this dropdown, right-click the node, and you get a "✒️ Show note of checkpoint" option that opens that model's personal wiki entry. That's the whole trick of Checkpoint Name List: it's a dropdown of every file in your models/checkpoints folder, and it's also the doorway into comfyui-mdnotes' markdown note system.

Why bother? Because the note part is the real payoff. If you've got a few dozen checkpoints downloaded, you know the pain - you load shiny_sdxl_v7_fix2.safetensors and have zero idea what it does, who trained it, or which VAE it pairs with. A markdown note sitting next to each model file, opened with one right-click, is the cheap fix for that. This node is just the plumbing that makes the picker visible and wireable: it's one of those value nodes (see the node-plumbing layer in the modidex KB) whose only job is "one authoritative selection, fanned out to whoever needs it."

Here's the mechanism, which is worth understanding because it explains everything else in the pack. The node exposes a widget named ckpt_name, and comfyui-mdnotes' frontend extension hunts for widgets whose name contains ckpt, lora, unet, or dfm on any node. When it finds one, it adds the "Show note of..." menu item. That's why the native CheckpointLoaderSimple also gets the menu - this node isn't the only way in. The note itself: right-click sends the model name to /mdnotes/current_model, the backend looks in the model's folder for .md files, scores each against the model filename with Python's difflib.SequenceMatcher, and opens the best match if it clears the similarity threshold (default 0.5, adjustable in settings). No match, and it creates a fresh blank note named after the model.

What you actually set: one input, ckpt_name, a dropdown auto-populated from models/checkpoints (it defaults to the first entry - pick the model you're documenting). The single output, Checkpoint Name, is typed *, ComfyUI's wildcard, so it plugs into anything expecting a model-name string. Want to actually drive a loader from it? Right-click the loader's name widget and choose "Convert widget to input," then wire this output in.

Installing is easy because the pack is nearly dependency-free: no pip packages, no model downloads, nothing to build. Via ComfyUI Manager, search "comfyui-mdnotes" and hit install, then restart ComfyUI. Or by hand:

cd ComfyUI/custom_nodes
git clone https://github.com/Endericedragon/comfyui-mdnotes
# restart ComfyUI

(The README lists a codeberg mirror of the same repo - either works.) One catch: the pack is written against ComfyUI's newer backend API and the window.comfyAPI frontend, so keep ComfyUI reasonably current or the nodes won't register.

Where people get burned: your notes are saved as plain .md files next to the model, inside models/checkpoints - fine, but don't be surprised to see them there, and back them up with the folder. If you right-click and get a blank note when you're sure one exists, the filename match fell below the threshold; name notes close to the model file or nudge the threshold slider. And if the editor window comes up empty, it's the Vditor editor loading its assets from a CDN - flip the "cache vditor resources locally" setting if you're offline or a CDN is blocked. For such a tiny utility pack, that's about all there is to trip on.