> ## Documentation Index > Fetch the complete documentation index at: https://mintlify.com/mermaid-js/mermaid/llms.txt > Use this file to discover all available pages before exploring further. # run() Finds and renders all Mermaid diagrams in the document. This method processes elements matching a selector (default: `.mermaid`), converting their text content into SVG diagrams. ## Signature ```typescript theme={null} async function run(options?: RunOptions): Promise ``` ## Parameters Optional configuration for the run operation. CSS selector for finding elements to render. Only used if `nodes` is not specified. Specific nodes to render. If provided, `querySelector` is ignored. Callback function called after each diagram is rendered, receiving the diagram's ID. If `true`, errors are logged to console but not thrown. ## Return value `Promise` - Resolves when all diagrams have been rendered. ## Behavior * Processes elements sequentially, not in parallel * Sets `data-processed="true"` attribute on rendered elements * Skips elements that already have `data-processed` attribute * Generates unique IDs for diagrams using format `mermaid-{n}` * Decodes HTML entities and normalizes whitespace in diagram definitions * Replaces element's `innerHTML` with rendered SVG * Throws first error encountered unless `suppressErrors` is `true` ## Examples ### Basic usage ```javascript theme={null} import mermaid from 'mermaid'; mermaid.initialize({ theme: 'dark' }); await mermaid.run(); ``` ### Custom selector ```javascript theme={null} // Render all elements with class "diagram" await mermaid.run({ querySelector: '.diagram' }); ``` ### Specific nodes ```javascript theme={null} // Render only specific elements const nodes = document.querySelectorAll('.custom-mermaid'); await mermaid.run({ nodes: nodes }); ``` ### With callback ```javascript theme={null} // Track rendered diagrams await mermaid.run({ postRenderCallback: (id) => { console.log(`Rendered diagram: ${id}`); // Perform additional operations } }); ``` ### Error suppression ```javascript theme={null} // Continue rendering even if some diagrams fail await mermaid.run({ suppressErrors: true }); ``` ### Complete example with HTML ```html theme={null}

graph TD A[Start] --> B[Process] B --> C[End]

sequenceDiagram Alice->>Bob: Hello Bob->>Alice: Hi!

``` ## Usage notes * Can be called multiple times; already-processed diagrams are skipped * Use `initialize()` before calling `run()` to configure Mermaid * Elements must be in the DOM before calling `run()` * The method processes `innerHTML`, so ensure content is properly escaped * Diagram text is dedented and trimmed before processing If `suppressErrors` is `false` (default), the first error will stop processing and throw. Use `suppressErrors: true` to render all valid diagrams even if some fail. ## Related methods * [initialize()](/api/methods/initialize) - Configure Mermaid before rendering * [render()](/api/methods/render) - Render a single diagram programmatically * [parse()](/api/methods/parse) - Validate diagram syntax without rendering