---
id: add-node-docs-for-your-comfyui-custom-node---comfyui
title: "Add node docs for your ComfyUI custom node - ComfyUI"
category: "10_Wiki/Topics"
status: "draft"
verification_status: "conceptual"
canonical_id: ""
aliases: []
duplicate_of: ""
source_trust_level: "B"
confidence_score: 0.8
created_at: 2026-05-20
updated_at: 2026-05-20
review_reason: ""
merge_history: []
tags: ["web", "wikify"]
raw_sources: ["https://docs.comfy.org/custom-nodes/help_page"]
applied_in: []
github_commit: ""
---

# [[Add node docs for your ComfyUI custom node - ComfyUI]]

## 🎯 한 줄 통찰 (One-line insight)
[[ComfyUI]] 커스텀 노드 개발자는 마크다운(Markdown) 파일을 활용하여 노드의 기능, 파라미터, 사용법을 포함한 풍부한 문서를 UI 내에 직접 구현할 수 있습니다.

## 🧠 핵심 개념 (Core concepts)
- **Rich Markdown Documentation**: 일반적인 노드 설명을 넘어 [[HTML]] 요소와 마크레이 형식을 사용하여 상세한 정보를 사용자에게 제공합니다.
- **Multi-language Support**: 언어별(영어, 중국어 등) 폴더 구조를 통해 다국어 문서를 지원하며, 사용자의 로케일에 따라 자동 로드됩니다.
- **Automated Fallback System**: 특정 언어의 문서가 없을 경우 기본값인 `NodeName.md`를 참조하도록 설계되었습니다.
- **Integrated UI Display**: 별도의 외부 페이지 없이 [[ComfyUI]] 인터페이스 내에서 직접 노드 문서를 확인할 수 있습니다.

## 🧩 추출된 패턴 (Extracted patterns)
- **계층적 문서 구조**: `WEB_DIRECTORY/docs/` 하위에 노드 이름을 따르는 폴더와 파일을 배치하는 정형화된 디렉토리 구조를 가집니다.
- **확장 가능한 마크다운 기능**: 표준 문법 외에도 이미지(`![]()`) 및 특정 속성을 가진 `<video>` 태그 등 HTML 요소를 결합하여 풍부한 콘텐츠를 구성합니다.

## 📖 세부 내용 (Details)

### 🛠️ Setup (설정 방법)
문서를 추가하기 위해서는 `WEB_DIRECTORY` 내에 `docs` 폴더를 생성하고 다음과 같은 규칙으로 파일을 배치해야 합니다.

| 파일 경로 예시 | 설명 |
| :--- | :--- |
| `WEB_DIRECTORY/docs/NodeName.md` | 기본(Fallback) 문서 (노드 이름은 `NODE_CLASS_MESSAGES`의 키값과 일치해야 함) |
| `WEB_DIRECTORY/docs/NodeName/en.md` | 영어 문서 |
| `WEB_DIRECTORY/docs/NodeName/zh.md` | 중국어 문서 |
| 기타 로케일 (예: `fr.md`, `de.md`) | 필요한 언어 추가 가능 |

### 📝 Supported Markdown Features (지원되는 마크다운 기능)
- **Standard Syntax**: 헤딩(Headings), 리스트(Lists), 코드 블록(Code blocks) 등 표준 문법 지원.
- **Images**: `![alt text](image.png)` 형식을 통한 이미지 삽입 가능.
- **HTML Media Elements**: `<video>` 및 `<source>` 태그 사용 가능.
    - 허용된 속성: `controls`, `autoplay`, `loop`, `muted`, `preload`, `poster`

### 📂 Example Structure (디렉토리 구조 예시)
커스텀 노드 패키지 내의 권장 구조는 다음과 같습니다.
```text
my-custom-node/
├── __init__.py
├── web/ # WEB_DIRECTORY
│   ├── js/
│   │   └── my-node.js
│   └── docs/
│       ├── MyNode.md (기본 문서)
│   └── MyNode/
│       ├── en.md (영어 버전)
│       └── zh.md (중국어 버전)
```

## ⚖️ 모다 및 업데이트 (Contradictions & updates)
- 본문 내 정보 간의 상충되는 내용은 발견되지 않았습니다.
- `ContextWindowsManualNode`와 관련하여, 이미 파라미터에 툴팁을 추가했다면 추가적인 노드 문서 없이도 정보를 참조할 수 있다는 구현 관련 언급이 있습니다.

## 🛠️ 적용 사례 (Applied in summary)
- **Example Markdown File**: 실제 작성 가능한 마크다운 파일의 예시로, 파라미터(`image`, `strength`), 사용법 설명, 이미지 및 비디오 태그가 포함된 구조를 제시하고 있습니다.

## ✅ 검증 상태 및 신뢰도
- **상태:** draft
- **검증 단계:** conceptual
- **출처 신뢰도:** B (Primary Source — 웹사이트 본문 직접 추출)
- **중복 검사 결과:** 신규 생성 (New discovery)

## 🔗 관련 문서 링크 (Related document links)
- [[ComfyUI]] : 문서를 적용할 대상인 커스텀 노드 프레임워크입니다.
- [[NODE_CLASS_MAPPINGS]] : 노드를 등록할 때 사용하는 딕셔너리로, 문서 파일명 결정의 기준이 됩니다.
- [[WEB_DIRECTORY]] : 문서 파일이 위치해야 하는 웹 디렉토리 경로를 정의합니다.

## 📝 변경 이력 (Change history)
- 2026-05-20: Astra /wikify 로 https://docs.comfy.org/custom-nodes/help_page 본문에서 초안 생성.