blender 5.3的comment节点可在节点树中显示多行markdown说明,且没有输入输出插槽,不参与节点计算。添加后直接编辑文字即可解释复杂设置;需要分组或移动一组节点时仍使用frame等组织工具。
添加并编辑注释
在节点编辑器添加Comment节点后,可双击它、选中按F2、悬停按Return,或在Sidebar → Node → Properties编辑文本。离开编辑状态后会显示格式化结果。
把说明放在对应节点或Frame附近,写清输入前提和参数用途。Comment只提供解释,不会为节点创建额外连接。

官方示例:Blender Comment节点格式化显示Markdown说明。
使用基本Markdown
可使用标题、加粗、斜体和列表等基本格式,先看渲染结果是否清晰。以下是内容示例,不代表节点表达式或脚本。
使用 SQLite FTS5 对结构化 Markdown 文档库进行全文搜索,适用于需要快速、高效搜索大量 Markdown 文章的场景。
# 材质参数说明 **输入要求**:使用已经校正色彩空间的纹理。 - 调整参数前保留原值 - 对比亮部与暗部的结果

官方示例:Blender Comment节点编辑状态。
区分说明和计算
Comment适合较长说明;Frame更适合组织节点组。嵌入Frame时背景会跟随层级变化,便于辨认。
修改注释不会改变节点求值结果。与团队共享文件前,核对文字中的参数名称和当前节点一致,不让过时说明误导后续编辑。

















