-
Notifications
You must be signed in to change notification settings - Fork 148
Description
Path: /custom-nodes/help_page---
title: "Add node docs for your ComfyUI custom node"
sidebarTitle: "Node docs"
description: "How to create rich documentation for your custom nodes"
Node Documentation with Markdown
Custom nodes can include rich markdown documentation that will be displayed in the UI instead of the generic node description. This provides users with detailed information about your node's functionality, parameters, and usage examples.
If you have already added tooltips for each parameter in the node definition, this basic information can be directly accessed via the node documentation panel.
No additional node documentation needs to be added, and you can refer to the related implementation of ContextWindowsManualNode
Setup
To add documentation for your custom nodes or multi-language support documentation:
- Create a
docsfolder inside yourWEB_DIRECTORY - Add markdown files named after your nodes (the names of your nodes are the dictionary keys in the
NODE_CLASS_MAPPINGSdictionary used to register the nodes):WEB_DIRECTORY/docs/NodeName.md- Default documentationWEB_DIRECTORY/docs/NodeName/en.md- English documentationWEB_DIRECTORY/docs/NodeName/zh.md- Chinese documentation- Add other locales as needed (e.g.,
fr.md,de.md, etc.)
The system will automatically load the appropriate documentation based on the user's locale, falling back to NodeName.md if a localized version is not available.
Supported Markdown Features
- Standard markdown syntax (headings, lists, code blocks, etc.)
- Images using markdown syntax:
 - HTML media elements with specific attributes:
<video>and<source>tags- Allowed attributes:
controls,autoplay,loop,muted,preload,poster
Example Structure
my-custom-node/
├── __init__.py
├── web/ # WEB_DIRECTORY
│ ├── js/
│ │ └── my-node.js
│ └── docs/
│ ├── MyNode.md # Fallback documentation
│ └── MyNode/
│ ├── en.md # English version
│ └── zh.md # Chinese version
Example Markdown File
# My Custom Node
This node processes images using advanced algorithms.
## Parameters
- **image**: Input image to process
- **strength**: Processing strength (0.0 - 1.0)
## Usage

<video controls loop muted>
<source src="demo.mp4" type="video/mp4">
</video>