Comfy-Org / docs

ComfyUI Documentation | English | 中文 | Development To preview documentation changes locally, first install dependencies and then start the development server: Create a PR Create a PR. Once it is accepted Vercel will deploy the change to https://docs.comfy.org/ Generating API Reference Docs Can either use an OpenAPI file or URL containing the file: This will only generate the MDX files for each endpoint. You need to add a link to these files in , and the up-to-date API spec will be shown on that doc page. Special Note on Renaming Files • Renaming files can cause some external links to become inaccessible, as they are already used in numerous articles and templates. • Since we can manage the sidebar navigation can be reorganized via the docs.json file, we generally do not change the original document's file location unless absolutely necessary. • If you renamed any files and caused the file path to be changed, please update the list in the A GitHub Action will check for redirects and fail the PR if they are missing. Redirects should follow this format: > > Don't forget to include the corresponding Chinese translation file in the directory as well! You can also refer to the Mintlify doc to learn how to add and match a wildcard path. About built-in node document ComfyUI now has a built-in node help menu for both built-in nodes and custom nodes. All built-in node documentation will now be maintained in this repo. Synchronization frequency We will regularly sync updated documentation from the corresponding repository to docs.comfy.org weekly to ensure content synchronization and updates. If you would like to contribute to the documentation, please submit PRs and updates to this repo. Node Documentation File Organization For node documentation, we will use a single-level directory structure under the folder for the following reasons: • ComfyUI may adjust node categories and directories during updates, using multi-level directory hierarchies means frequent adjustments to node documentation • These frequent adjustments mean we need to frequently add redirects and checks • Mintlify supports setting document hierarchy in the file, so we can make unified changes in that file > Due to historical updates, some existing documents use different folder hierarchies. We will no longer adjust these files, but new files will use a single-level directory Contributing Please just create a PR and we will review it within a few days. Or talk to us on our discord The documentation is built with Mintlify, please refer to Mintlify documentation to learn how to use it. i18n Contributions Mintlify uses versioning to add other languages. To add a translation of a page, follow these instructions: • Create a file under the language code with the same exact filename of the original English filename. For example: If you are translating into Chinese, create a file under . Specifications for file editing can be found in the Writing Content section of the Mintlify document > **Important**: When you modify an existing MDX file in the English documentation, you must also update the corresponding file in the directory. A GitHub Action will automatically check for this and fail the PR if the corresponding Chinese translations are not updated. • Update navigation for Please refer to Mintlify Localization for configuration details. If you translated a single page, just add the new translated page path to the corresponding language navigation group, and it will be displayed in that language version. For : Mintlify will automatically determine which pages to display in different language versions based on the configuration. Currently, Mintlify supports localization for English (en), Chinese (cn), Spanish (es), French (fr), Japanese (jp), Portuguese (pt), Brazilian Portuguese (pt-BR), and German (de). For more information, please refer to the Mintlify documentation on Mintlify Localization. Adding a new language If a language doesn't exist yet, for example, if you want to add a French translation of , you should create a new folder in the root directory, complete the translation, and then add the following content under in : The locale will translate Mintlify default UI components' text. This is optional. The full list of locales are here. Contributing Workflow Examples When adding workflow examples to the documentation, please: • Take your output from ComfyUI (PNG, WebP), and add the models urls to the workflow so a user will have them when they drag in the workflow. You can use this tool to edit the metadata of the PNG or WebP file. • Upload your workflow JSON and preview image to the example_workflows repository • Use the raw GitHub content URL in your documentation. To convert a GitHub file URL to a raw content URL: • Start with your GitHub file URL: • Change it to raw.githubusercontent.com and remove '/blob': You can also click the "Raw" button on the GitHub file page and copy the URL directly. This ensures the workflow metadata is preserved in the docs site when dragging it into ComfyUI.