markdraw

https://pub.dev/packages/markdraw
Admin
An Excalidraw-inspired drawing widget for Flutter with human-readable markdown serialization and...
Tokens:9,453
Snippets:112
Trust Score:9.9
Update:5 months ago
Show doc for...
Tokens:
Raw
### Full Markdraw Example with File I/O

Source: https://pub.dev/packages/markdraw

A comprehensive example demonstrating file open/save, PNG/SVG export, image import, and library management using MarkdrawFileHandler. This setup includes a controller and file handling logic.

```dart
import 'package:flutter/material.dart' hide Element, SelectionOverlay;
import 'package:markdraw/markdraw.dart' hide TextAlign;

void main() {
  runApp(MarkdrawApp(
    home: (context, themeMode, onThemeModeChanged) => _CanvasPage(
      themeMode: themeMode,
      onThemeModeChanged: onThemeModeChanged,
    ),
  ));
}

class _CanvasPage extends StatefulWidget {
  const _CanvasPage({
    required this.themeMode,
    required this.onThemeModeChanged,
  });

  final ThemeMode themeMode;
  final void Function(ThemeMode) onThemeModeChanged;

  @override
  State<_CanvasPage> createState() => _CanvasPageState();
}

class _CanvasPageState extends State<_CanvasPage> {
  final _controller = MarkdrawController();
  late final _files = MarkdrawFileHandler(controller: _controller);

  @override
  void dispose() {
    _controller.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return MarkdrawEditor(
      controller: _controller,
      onSave: _files.save,
      onSaveAs: _files.saveAs,
      onOpen: _files.open,
      onExportPng: _files.exportPng,
      onExportSvg: _files.exportSvg,
      onImportImage: () => _files.importImage(context),
      onImportLibrary: _files.importLibrary,
      onExportLibrary: _files.exportLibrary,
      onThemeModeChanged: widget.onThemeModeChanged,
      currentThemeMode: widget.themeMode,
    );
  }
}
```

--------------------------------

### Markdraw Editor Example App

Source: https://pub.dev/packages/markdraw/example

Example app demonstrating the MarkdrawEditor widget. It utilizes MarkdrawFileHandler for file operations and includes basic setup for running the app.

```dart
/// Example app using the MarkdrawEditor widget.
///
/// File I/O is handled by [MarkdrawFileHandler], which ships with the
/// package and wires file_picker + platform I/O to the controller.
///
/// Usage:
///   cd example && flutter run
library;

import 'package:flutter/material.dart' hide Element, SelectionOverlay;
import 'package:url_launcher/url_launcher.dart';

import 'package:markdraw/markdraw.dart' hide TextAlign;

void main() {
  runApp(MarkdrawApp(
    home: (context, themeMode, onThemeModeChanged) => _CanvasPage(
      themeMode: themeMode,
      onThemeModeChanged: onThemeModeChanged,
    ),
  ));
}

class _CanvasPage extends StatefulWidget {
  const _CanvasPage({
    required this.themeMode,
    required this.onThemeModeChanged,
  });

  final ThemeMode themeMode;
  final void Function(ThemeMode) onThemeModeChanged;

  @override
  State<_CanvasPage> createState() => _CanvasPageState();
}

class _CanvasPageState extends State<_CanvasPage> {
  final _controller = MarkdrawController(
    config: MarkdrawEditorConfig(
      onLinkOpen: (url) => launchUrl(Uri.parse(url)),
    ),
  );
  late final _files = MarkdrawFileHandler(controller: _controller);

  @override
  void dispose() {
    _controller.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return MarkdrawEditor(
      controller: _controller,
      onSave: _files.save,
      onSaveAs: _files.saveAs,
      onOpen: _files.open,
      onExportPng: _files.exportPng,
      onExportSvg: _files.exportSvg,
      onImportImage: () => _files.importImage(context),
      onImportLibrary: _files.importLibrary,
      onExportLibrary: _files.exportLibrary,
      onThemeModeChanged: widget.onThemeModeChanged,
      currentThemeMode: widget.themeMode,
    );
  }
}

```

--------------------------------

### Quick Start: Minimal Markdraw Canvas

Source: https://pub.dev/packages/markdraw/versions/0.2.0

A concise six-line example demonstrating how to set up a basic Markdraw drawing canvas. This provides a full editor with essential features without requiring explicit file I/O configuration.

```dart
import 'package:flutter/material.dart' hide Element, SelectionOverlay;
import 'package:markdraw/markdraw.dart' hide TextAlign;

void main() {
  runApp(MarkdrawApp(
    home: (context, themeMode, onThemeModeChanged) => MarkdrawEditor(
      currentThemeMode: themeMode,
      onThemeModeChanged: onThemeModeChanged,
    ),
  ));
}

```

--------------------------------

### Full Example with File I/O and MarkdrawFileHandler

Source: https://pub.dev/packages/markdraw/versions/0.2.0

An example app showcasing file open/save, PNG/SVG export, image import, and library management using the MarkdrawFileHandler. This setup provides a comprehensive user experience for managing drawings.

```dart
import 'package:flutter/material.dart' hide Element, SelectionOverlay;
import 'package:markdraw/markdraw.dart' hide TextAlign;

void main() {
  runApp(MarkdrawApp(
    home: (context, themeMode, onThemeModeChanged) => _CanvasPage(
      themeMode: themeMode,
      onThemeModeChanged: onThemeModeChanged,
    ),
  ));
}

class _CanvasPage extends StatefulWidget {
  const _CanvasPage({
    required this.themeMode,
    required this.onThemeModeChanged,
  });

  final ThemeMode themeMode;
  final void Function(ThemeMode) onThemeModeChanged;

  @override
  State<_CanvasPage> createState() => _CanvasPageState();
}

class _CanvasPageState extends State<_CanvasPage> {
  final _controller = MarkdrawController();
  late final _files = MarkdrawFileHandler(controller: _controller);

  @override
  void dispose() {
    _controller.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return MarkdrawEditor(
      controller: _controller,
      onSave: _files.save,
      onSaveAs: _files.saveAs,
      onOpen: _files.open,
      onExportPng: _files.exportPng,
      onExportSvg: _files.exportSvg,
      onImportImage: () => _files.importImage(context),
      onImportLibrary: _files.importLibrary,
      onExportLibrary: _files.exportLibrary,
      onThemeModeChanged: widget.onThemeModeChanged,
      currentThemeMode: widget.themeMode,
    );
  }
}

```

--------------------------------

### Minimal Markdraw Canvas Setup

Source: https://pub.dev/packages/markdraw

Provides a basic Markdraw editor canvas with essential functionality. No file I/O is configured in this minimal setup.

```dart
import 'package:flutter/material.dart' hide Element, SelectionOverlay;
import 'package:markdraw/markdraw.dart' hide TextAlign;

void main() {
  runApp(MarkdrawApp(
    home: (context, themeMode, onThemeModeChanged) => MarkdrawEditor(
      currentThemeMode: themeMode,
      onThemeModeChanged: onThemeModeChanged,
    ),
  ));
}
```

--------------------------------

### Markdraw File Format Example

Source: https://pub.dev/packages/markdraw/versions/0.2.0

Drawings are saved as markdown files with embedded sketch blocks. This format is human-readable, git-friendly, and diffable. It preserves prose and maps sketch elements to Excalidraw types.

```markdown
---
markdraw: 1
background: "#ffffff"
grid: 20
---

# Architecture Overview

Here's how the services connect:

```sketch
rect "Auth Service" id=auth at 100,200 size 160x80 fill=#e3f2fd rounded
rect "API Gateway" id=gateway at 350,200 size 160x80 fill=#fff3e0 rounded
arrow from auth to gateway label="JWT tokens" stroke=dashed
ellipse "Database" id=db at 225,400 size 120x80 fill=#e8f5e9
arrow from gateway to db label="queries"
```

The auth service handles OAuth2 flows.

```

```

--------------------------------

### Markdraw File Format Example

Source: https://pub.dev/packages/markdraw

Drawings are saved in a markdown format with embedded sketch blocks. This format is human-readable, git-friendly, and diffable, preserving prose sections and mapping elements to Excalidraw types.

```markdown
---
markdraw: 1
background: "#ffffff"
grid: 20
---

# Architecture Overview

Here's how the services connect:

```sketch
rect "Auth Service" id=auth at 100,200 size 160x80 fill=#e3f2fd rounded
rect "API Gateway" id=gateway at 350,200 size 160x80 fill=#fff3e0 rounded
arrow from auth to gateway label="JWT tokens" stroke=dashed
ellipse "Database" id=db at 225,400 size 120x80 fill=#e8f5e9
arrow from gateway to db label="queries"
```

The auth service handles OAuth2 flows.


```

--------------------------------

### Markdraw Dependency in pubspec.yaml

Source: https://pub.dev/packages/markdraw/install

This is an example of how the markdraw dependency will appear in your pubspec.yaml file after running `flutter pub add markdraw`.

```yaml
dependencies:
  markdraw: ^0.2.0
```

--------------------------------

### Import Markdraw Package in Dart Code

Source: https://pub.dev/packages/markdraw/install

Import the markdraw package into your Dart files to start using its functionalities. Ensure this line is present at the top of your Dart file.

```dart
import 'package:markdraw/markdraw.dart';
```

--------------------------------

### Theming

Source: https://pub.dev/packages/markdraw/versions/0.2.0

How to manage and apply theme modes within the Markdraw editor.

```APIDOC
## Theming

`MarkdrawApp` manages `ThemeMode` state internally. Wire it to `MarkdrawEditor` via the builder:

```dart
MarkdrawApp(
  home: (context, themeMode, onThemeModeChanged) => MarkdrawEditor(
    currentThemeMode: themeMode,
    onThemeModeChanged: onThemeModeChanged,
  ),
)
```

If you manage your own `MaterialApp`, pass `ThemeMode` and a toggle callback directly to `MarkdrawEditor`.
```

--------------------------------

### Excalidraw Interop

Source: https://pub.dev/packages/markdraw/versions/0.2.0

Import and export `.excalidraw` JSON files and `.excalidrawlib` library files.

```APIDOC
## Excalidraw Interop

Import and export `.excalidraw` JSON files:

```dart
// Import
controller.loadFromContent(jsonString, 'drawing.excalidraw');

// Export
final json = controller.serializeScene(format: DocumentFormat.excalidraw);
```

Library files (`.excalidrawlib`) are also supported:

```dart
controller.importLibraryFromContent(content, 'shapes.excalidrawlib');
final libJson = controller.exportLibraryContent(
  format: DocumentFormat.excalidrawLibrary,
);
```
```

--------------------------------

### MarkdrawApp Wrapper

Source: https://pub.dev/packages/markdraw

A lightweight `MaterialApp` wrapper that manages `ThemeMode` state.

```APIDOC
## MarkdrawApp

A lightweight `MaterialApp` wrapper that manages `ThemeMode` state and passes it to your builder:

### Constructor Parameters

- **`title`** (String) - The title of the application.
- **`initialThemeMode`** (ThemeMode) - The initial theme mode (e.g., `ThemeMode.system`).
- **`colorSchemeSeed`** (Color) - A seed color for generating the color scheme.
- **`home`** (Widget Function) - A builder function that receives `context`, `themeMode`, and `onThemeModeChanged` to build the home screen.

### Example Usage
```dart
MarkdrawApp(
  title: 'My Drawing App',
  initialThemeMode: ThemeMode.system,
  colorSchemeSeed: Colors.blue,
  home: (context, themeMode, onThemeModeChanged) => YourWidget(...),
)
```
```

--------------------------------

### MarkdrawApp

Source: https://pub.dev/packages/markdraw/versions/0.2.0

A lightweight `MaterialApp` wrapper that manages `ThemeMode` state and passes it to your builder.

```APIDOC
### MarkdrawApp

A lightweight `MaterialApp` wrapper that manages `ThemeMode` state and passes it to your builder:

```dart
MarkdrawApp(
  title: 'My Drawing App',
  initialThemeMode: ThemeMode.system,
  colorSchemeSeed: Colors.blue,
  home: (context, themeMode, onThemeModeChanged) => YourWidget(...),
)
```
```

--------------------------------

### Flutter Development Commands

Source: https://pub.dev/packages/markdraw

Common Flutter commands for testing, analysis, and coverage reporting. Run all tests, check test output, perform static analysis, and generate HTML coverage reports.

```bash
# Run all tests
flutter test

# Run tests and check output
flutter test 2>&1 > /tmp/test.txt

# Static analysis
flutter analyze

# Generate coverage report
flutter test --coverage
genhtml coverage/lcov.info -o coverage/html

```

--------------------------------

### MarkdrawFileHandler

Source: https://pub.dev/packages/markdraw/versions/0.2.0

Wires file picking and platform I/O to a controller, providing methods for saving, opening, exporting, and importing files.

```APIDOC
### MarkdrawFileHandler

Wires `file_picker` and platform I/O to a controller. Provides `save`, `saveAs`, `open`, `exportPng`, `exportSvg`, `importImage`, `importLibrary`, and `exportLibrary` methods.
```

--------------------------------

### Run Flutter Tests

Source: https://pub.dev/packages/markdraw/versions/0.2.0

Execute all tests in the project using `flutter test`. For detailed output, redirect stderr to a file.

```bash
# Run all tests
flutter test

# Run tests and check output
flutter test 2>&1 > /tmp/test.txt

```

--------------------------------

### Flutter Static Analysis and Coverage

Source: https://pub.dev/packages/markdraw/versions/0.2.0

Perform static analysis on the project using `flutter analyze`. Generate a coverage report by running tests with the `--coverage` flag and processing the lcov output.

```bash
# Static analysis
flutter analyze

# Generate coverage report
flutter test --coverage
genhtml coverage/lcov.info -o coverage/html

```

--------------------------------

### Basic Markdraw App Wrapper

Source: https://pub.dev/packages/markdraw/versions/0.2.0

Use MarkdrawApp as a lightweight MaterialApp wrapper to manage ThemeMode state and pass it to your builder. Configure title, initial theme, and color scheme.

```dart
MarkdrawApp(
  title: 'My Drawing App',
  initialThemeMode: ThemeMode.system,
  colorSchemeSeed: Colors.blue,
  home: (context, themeMode, onThemeModeChanged) => YourWidget(...),
)

```

--------------------------------

### Import and Export Excalidraw JSON

Source: https://pub.dev/packages/markdraw/versions/0.2.0

Load drawing content from Excalidraw JSON strings using `loadFromContent` and serialize the current scene to Excalidraw JSON format using `serializeScene`.

```dart
// Import
controller.loadFromContent(jsonString, 'drawing.excalidraw');

// Export
final json = controller.serializeScene(format: DocumentFormat.excalidraw);

```

--------------------------------

### Configure Markdraw Editor

Source: https://pub.dev/packages/markdraw/versions/0.2.0

Define immutable configuration for the editor or controller using MarkdrawEditorConfig. Specify tools, initial background, and visibility of UI elements.

```dart
MarkdrawEditorConfig(
  tools: [ToolType.select, ToolType.rectangle, ToolType.text],
  initialBackground: '#f5f5f5',
  showToolbar: true,
  showPropertyPanel: true,
  showZoomControls: true,
  showHelpButton: true,
  showLibraryPanel: true,
  showMarkdownButton: true,
  showMenu: true,
  compactBreakpoint: 600.0,
  minZoom: 0.1,
  maxZoom: 30.0,
)

```

--------------------------------

### Import and Export Excalidraw Library

Source: https://pub.dev/packages/markdraw/versions/0.2.0

Import library content from Excalidraw library files and export the current library content in Excalidraw library format.

```dart
controller.importLibraryFromContent(content, 'shapes.excalidrawlib');
final libJson = controller.exportLibraryContent(
  format: DocumentFormat.excalidrawLibrary,
);

```

--------------------------------

### MarkdrawEditorConfig

Source: https://pub.dev/packages/markdraw

Immutable configuration options for the Markdraw editor.

```APIDOC
## MarkdrawEditorConfig

Immutable configuration passed to the editor or controller:

### Constructor Parameters

- **`tools`** (List<ToolType>) - Optional - A list of `ToolType`s to enable in the editor.
- **`initialBackground`** (String) - Optional - The initial background color of the canvas (e.g., '#f5f5f5').
- **`showToolbar`** (bool) - Optional - Whether to display the toolbar.
- **`showPropertyPanel`** (bool) - Optional - Whether to display the property panel.
- **`showZoomControls`** (bool) - Optional - Whether to display the zoom controls.
- **`showHelpButton`** (bool) - Optional - Whether to display the help button.
- **`showLibraryPanel`** (bool) - Optional - Whether to display the library panel.
- **`showMarkdownButton`** (bool) - Optional - Whether to display the markdown button.
- **`showMenu`** (bool) - Optional - Whether to display the main menu.
- **`compactBreakpoint`** (double) - Optional - The screen width breakpoint for compact layout.
- **`minZoom`** (double) - Optional - The minimum zoom level.
- **`maxZoom`** (double) - Optional - The maximum zoom level.

### Example Usage
```dart
MarkdrawEditorConfig(
  tools: [ToolType.select, ToolType.rectangle, ToolType.text],
  initialBackground: '#f5f5f5',
  showToolbar: true,
  showPropertyPanel: true,
  showZoomControls: true,
  showHelpButton: true,
  showLibraryPanel: true,
  showMarkdownButton: true,
  showMenu: true,
  compactBreakpoint: 600.0,
  minZoom: 0.1,
  maxZoom: 30.0,
)
```
```

--------------------------------

### MarkdrawController

Source: https://pub.dev/packages/markdraw/versions/0.2.0

Manages editor state, tools, history, and serialization. Allows programmatic control over the editor.

```APIDOC
## MarkdrawController

Manages editor state, tools, history, and serialization. Create one to control the editor programmatically:

```dart
final controller = MarkdrawController();

// Switch tools
controller.switchTool(ToolType.rectangle);

// Undo/redo
controller.undo();
controller.redo();

// Zoom
controller.zoomIn(canvasSize);
controller.zoomToFit(canvasSize);
controller.resetZoom();

// Serialize
final markdraw = controller.serializeScene();
final json = controller.serializeScene(format: DocumentFormat.excalidraw);

// Load
controller.loadFromContent(content, 'drawing.markdraw');

// Export
final pngBytes = await controller.exportPng();
final svgString = controller.exportSvg();

// Listen for changes
controller.addListener(() { /* rebuild */ });
```
```

--------------------------------

### Excalidraw Interoperability

Source: https://pub.dev/packages/markdraw

Import and export drawings in Excalidraw JSON format.

```APIDOC
## Excalidraw Interop

Import and export `.excalidraw` JSON files:

### Import
```dart
controller.loadFromContent(jsonString, 'drawing.excalidraw');
```

### Export
```dart
final json = controller.serializeScene(format: DocumentFormat.excalidraw);
```

Library files (`.excalidrawlib`) are also supported:

### Import Library
```dart
controller.importLibraryFromContent(content, 'shapes.excalidrawlib');
```

### Export Library
```dart
final libJson = controller.exportLibraryContent(
  format: DocumentFormat.excalidrawLibrary,
);
```
```

--------------------------------

### Integrate Theming with MarkdrawEditor

Source: https://pub.dev/packages/markdraw/versions/0.2.0

Wire ThemeMode state from MarkdrawApp to MarkdrawEditor. If managing your own MaterialApp, pass ThemeMode and a toggle callback directly to MarkdrawEditor.

```dart
MarkdrawApp(
  home: (context, themeMode, onThemeModeChanged) => MarkdrawEditor(
    currentThemeMode: themeMode,
    onThemeModeChanged: onThemeModeChanged,
  ),
)

```

--------------------------------

### Control Markdraw Editor Programmatically

Source: https://pub.dev/packages/markdraw/versions/0.2.0

Use MarkdrawController to manage editor state, tools, history, and serialization. Instantiate it to control the editor programmatically.

```dart
final controller = MarkdrawController();

// Switch tools
controller.switchTool(ToolType.rectangle);

// Undo/redo
controller.undo();
controller.redo();

// Zoom
controller.zoomIn(canvasSize);
controller.zoomToFit(canvasSize);
controller.resetZoom();

// Serialize
final markdraw = controller.serializeScene();
final json = controller.serializeScene(format: DocumentFormat.excalidraw);

// Load
controller.loadFromContent(content, 'drawing.markdraw');

// Export
final pngBytes = await controller.exportPng();
final svgString = controller.exportSvg();

// Listen for changes
controller.addListener(() { /* rebuild */ });

```

--------------------------------

### MarkdrawController Methods

Source: https://pub.dev/packages/markdraw

Provides programmatic control over the Markdraw editor's state, tools, history, and serialization.

```APIDOC
## MarkdrawController

Manages editor state, tools, history, and serialization. Create one to control the editor programmatically:

### Methods

- **`MarkdrawController()`**: Constructor to create a new controller instance.
- **`switchTool(ToolType tool)`**: Switches the active tool to the specified `ToolType`.
- **`undo()`**: Undoes the last action.
- **`redo()`**: Redoes the last undone action.
- **`zoomIn(Size canvasSize)`**: Zooms the canvas in.
- **`zoomToFit(Size canvasSize)`**: Zooms the canvas to fit the available space.
- **`resetZoom()`**: Resets the zoom level to the default.
- **`serializeScene({DocumentFormat? format})`**: Serializes the current scene. Optionally specify `DocumentFormat.excalidraw` for Excalidraw JSON export.
- **`loadFromContent(String content, String filename)`**: Loads drawing content from a string, specifying the filename.
- **`exportPng()`**: Exports the current scene as PNG bytes.
- **`exportSvg()`**: Exports the current scene as an SVG string.
- **`addListener(VoidCallback listener)`**: Adds a listener to be called when the controller's state changes.

### Example Usage
```dart
final controller = MarkdrawController();

// Switch tools
controller.switchTool(ToolType.rectangle);

// Undo/redo
controller.undo();
controller.redo();

// Zoom
controller.zoomIn(canvasSize);
controller.zoomToFit(canvasSize);
controller.resetZoom();

// Serialize
final markdraw = controller.serializeScene();
final json = controller.serializeScene(format: DocumentFormat.excalidraw);

// Load
controller.loadFromContent(content, 'drawing.markdraw');

// Export
final pngBytes = await controller.exportPng();
final svgString = controller.exportSvg();

// Listen for changes
controller.addListener(() { /* rebuild */ });
```
```

--------------------------------

### MarkdrawEditorConfig

Source: https://pub.dev/packages/markdraw/versions/0.2.0

Immutable configuration passed to the editor or controller to customize its appearance and behavior.

```APIDOC
## MarkdrawEditorConfig

Immutable configuration passed to the editor or controller:

```dart
MarkdrawEditorConfig(
  tools: [ToolType.select, ToolType.rectangle, ToolType.text],
  initialBackground: '#f5f5f5',
  showToolbar: true,
  showPropertyPanel: true,
  showZoomControls: true,
  showHelpButton: true,
  showLibraryPanel: true,
  showMarkdownButton: true,
  showMenu: true,
  compactBreakpoint: 600.0,
  minZoom: 0.1,
  maxZoom: 30.0,
)
```
```

--------------------------------

### MarkdrawFileHandler

Source: https://pub.dev/packages/markdraw

Handles file operations for the Markdraw editor, including saving, opening, and exporting.

```APIDOC
## MarkdrawFileHandler

Wires `file_picker` and platform I/O to a controller. Provides `save`, `saveAs`, `open`, `exportPng`, `exportSvg`, `importImage`, `importLibrary`, and `exportLibrary` methods.
```

--------------------------------

### Add Markdraw Dependency to Flutter Project

Source: https://pub.dev/packages/markdraw/install

Use this command to add the markdraw package to your Flutter project's dependencies. This command automatically updates your pubspec.yaml file.

```bash
 $ flutter pub add markdraw
```

--------------------------------

### MarkdrawEditor Widget

Source: https://pub.dev/packages/markdraw

The main widget for the Markdraw editor. It provides a canvas for drawing and various optional callbacks for handling user interactions like saving, opening, exporting, and theme changes.

```APIDOC
## MarkdrawEditor

### Description
The main widget. All callbacks are optional — omit any you don't need.

### Parameters
#### Widget Parameters
- `controller` (MarkdrawController?) - External controller; one is created internally if omitted
- `config` (MarkdrawEditorConfig) - UI and behavior configuration

#### Callback Parameters
- `onSave` (VoidCallback?) - Save to current file
- `onSaveAs` (VoidCallback?) - Save-as dialog
- `onOpen` (VoidCallback?) - Open file dialog
- `onExportPng` (VoidCallback?) - Export as PNG
- `onExportSvg` (VoidCallback?) - Export as SVG
- `onImportImage` (VoidCallback?) - Import an image
- `onImportLibrary` (VoidCallback?) - Import a library file
- `onExportLibrary` (VoidCallback?) - Export the library
- `onThemeModeChanged` (void Function(ThemeMode)?) - Theme toggle callback
- `currentThemeMode` (ThemeMode?) - Current theme mode
- `onSceneChanged` (void Function(Scene)?) - Called on every scene mutation
```

--------------------------------

### MarkdrawEditor Widget

Source: https://pub.dev/packages/markdraw/versions/0.2.0

The main widget for the markdraw editor. It provides a canvas for drawing and integrates with various callbacks for saving, opening, exporting, and theme management.

```APIDOC
## MarkdrawEditor

### Description
The main widget. All callbacks are optional — omit any you don't need.

### Parameters
#### Optional Parameters
- **controller** (`MarkdrawController?`) - External controller; one is created internally if omitted
- **config** (`MarkdrawEditorConfig`) - UI and behavior configuration
- **onSave** (`VoidCallback?`) - Save to current file
- **onSaveAs** (`VoidCallback?`) - Save-as dialog
- **onOpen** (`VoidCallback?`) - Open file dialog
- **onExportPng** (`VoidCallback?`) - Export as PNG
- **onExportSvg** (`VoidCallback?`) - Export as SVG
- **onImportImage** (`VoidCallback?`) - Import an image
- **onImportLibrary** (`VoidCallback?`) - Import a library file
- **onExportLibrary** (`VoidCallback?`) - Export the library
- **onThemeModeChanged** (`void Function(ThemeMode)?`) - Theme toggle callback
- **currentThemeMode** (`ThemeMode?`) - Current theme mode
- **onSceneChanged** (`void Function(Scene)?`) - Called on every scene mutation
```
Tokens:
Raw