Skip to content

VitePress Diagrams DemoTesting @file: Import Feature

A demo site for the vitepress-plugin-diagrams file import functionality

Welcome! ๐Ÿ‘‹ โ€‹

This demo site showcases the new @file: syntax for importing diagrams from external files in vitepress-plugin-diagrams.

Features Demonstrated โ€‹

  1. Inline Diagrams - Traditional way of writing diagrams directly in markdown
  2. File Imports - New @file: syntax for importing diagrams from external files

Quick Example โ€‹

markdown
```bpmn
@file:./diagrams/process.bpmn
```
<!-- diagram id="1" caption: "Business Process" -->

Why Use File Imports? โ€‹

  • ๐ŸŽจ Better Editor Support - Use dedicated diagram editors (BPMN editors, PlantUML IDEs, etc.)
  • ๐Ÿ”„ Reusability - Share diagram definitions across multiple pages
  • ๐Ÿ“ Cleaner Markdown - Keep your documentation focused on content
  • ๐Ÿงช Version Control - Track diagram changes separately