• English
  • Getting Started

    This section helps you add Graphviz support for Rspress.

    Install

    # npm
    npm i rspress-plugin-viz @viz-js/viz -D
    
    # pnpm
    pnpm add -D rspress-plugin-viz @viz-js/viz
    
    # yarn
    yarn add -D rspress-plugin-viz @viz-js/viz

    Setup

    Register the plugin in your Rspress config.

    // rspress.config.ts
    import { defineConfig } from '@rspress/core';
    import viz from 'rspress-plugin-viz';
    
    export default defineConfig({
      plugins: [viz()],
    });

    Usage

    Use the viz language block in your Markdown files.

    ```viz
    digraph G {
      rankdir=LR
      a -> b [label="a to b"];
      b -> c [label="another label"];
    }
    ```

    This will be rendered as:

    Loading graph...

    Usage notes:

    • Optional scaling: add a scale factor after the language name, e.g. {0.75}.
    ```viz {0.75}
    digraph G {
      a -> b;
    }
    ```

    Rendered result:

    Loading graph...

    Advanced Configuration

    viz accepts the following options:

    interface PluginVizOptions {
      /**
       * Custom CSS class for the wrapper div.
       */
      className?: string;
    
      /**
       * Compatibility alias for className.
       */
      class?: string;
    
      /**
       * Default SVG size scale.
       * @default 1
       */
      scale?: number;
    }

    Acknowledgments