aboutsummaryrefslogtreecommitdiffstats
path: root/dev-docs/docs/@excalidraw/mermaid-to-excalidraw/installation.mdx
diff options
context:
space:
mode:
Diffstat (limited to 'dev-docs/docs/@excalidraw/mermaid-to-excalidraw/installation.mdx')
-rw-r--r--dev-docs/docs/@excalidraw/mermaid-to-excalidraw/installation.mdx42
1 files changed, 42 insertions, 0 deletions
diff --git a/dev-docs/docs/@excalidraw/mermaid-to-excalidraw/installation.mdx b/dev-docs/docs/@excalidraw/mermaid-to-excalidraw/installation.mdx
new file mode 100644
index 0000000..1860fdf
--- /dev/null
+++ b/dev-docs/docs/@excalidraw/mermaid-to-excalidraw/installation.mdx
@@ -0,0 +1,42 @@
+# Installation
+
+`@excalidraw/mermaid-to-excalidraw` is published to npm. This library is used in [excalidraw](https://excalidraw.com) to transform mermaid syntax to Excalidraw diagrams.
+
+Using `npm`
+
+```bash
+npm install @excalidraw/mermaid-to-excalidraw
+```
+
+Using `yarn`
+
+```bash
+yarn add @excalidraw/mermaid-to-excalidraw
+```
+
+## Usage
+
+Once the library is installed, its ready to use.
+
+```js
+import { parseMermaidToExcalidraw } from "@excalidraw/mermaid-to-excalidraw";
+import { convertToExcalidrawElements} from "@excalidraw/excalidraw"
+
+try {
+ const { elements, files } = await parseMermaid(diagramDefinition, {
+ fontSize: DEFAULT_FONT_SIZE,
+ });
+ // currently the elements returned from the parser are in a "skeleton" format
+ // which we need to convert to fully qualified excalidraw elements first
+ const excalidrawElements = convertToExcalidrawElements(elements);
+
+ // Render elements and files on Excalidraw
+} catch (e) {
+ // Error handling
+}
+```
+
+## Playground
+
+ Try it out [here](https://mermaid-to-excalidraw.vercel.app)
+