vinay/obsidian-mermaid-links
1
0
Fork 0
mirror of https://github.com/vinayaugustine/obsidian-mermaid-links.git synced 2025-12-05 20:38:59 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions
No description
3 commits 1 branch 0 tags 72 KiB
TypeScript 73.6%
JavaScript 24%
CSS 2.4%
Find a file
Vinay Augustine dbacb3f5af Updated README.md and license 
* Updated README.md with basic instructions
* Change license to MIT licensed by me
2025-03-11 10:25:03 -04:00
.editorconfig Initial commit 2025-03-10 16:56:36 -04:00
.eslintignore Initial commit 2025-03-10 16:56:36 -04:00
.eslintrc Initial commit 2025-03-10 16:56:36 -04:00
.gitignore Initial commit 2025-03-10 16:56:36 -04:00
.npmrc Initial commit 2025-03-10 16:56:36 -04:00
esbuild.config.mjs Initial commit 2025-03-10 16:56:36 -04:00
LICENSE Updated README.md and license 2025-03-11 10:25:03 -04:00
main.ts Initial commit 2025-03-10 18:34:20 -04:00
manifest.json Initial commit 2025-03-10 18:34:20 -04:00
package-lock.json Initial commit 2025-03-10 18:34:20 -04:00
package.json Initial commit 2025-03-10 18:34:20 -04:00
README.md Updated README.md and license 2025-03-11 10:25:03 -04:00
styles.css Initial commit 2025-03-10 16:56:36 -04:00
tsconfig.json Initial commit 2025-03-10 16:56:36 -04:00
version-bump.mjs Initial commit 2025-03-10 16:56:36 -04:00
versions.json Initial commit 2025-03-10 16:56:36 -04:00

README.md

Obsidian Mermaid Links

A plugin for Obsidian that adds convenient "Edit" and "Full Screen" links to all your Mermaid diagrams.

Features

  • Automatically adds links below any Mermaid diagram in your notes
  • "Edit" link opens the diagram in Mermaid Live Editor for easy modification
  • "Full Screen" link opens the diagram in Mermaid Live Viewer for better visibility
  • Customizable link text through plugin settings

How It Works

The plugin scans your notes for Mermaid code blocks and adds two links below each diagram:

  1. Edit: Opens the diagram in Mermaid Live Editor, allowing you to modify the diagram in a specialized editor
  2. Full Screen: Opens the diagram in Mermaid Live Viewer, providing a clean, full-screen view

Both links use Mermaid Live's PAKO compression format to transfer your diagram code efficiently.

Installation

  1. Open Obsidian Settings
  2. Go to Community Plugins and disable Safe Mode
  3. Click "Browse" and search for "Mermaid Links"
  4. Install the plugin and enable it

Or install manually:

  • Download the latest release from the GitHub releases page
  • Extract the files into your vault's .obsidian/plugins/obsidian-mermaid-links folder
  • Reload Obsidian and enable the plugin in the settings

Configuration

You can customize the text displayed for both links in the plugin settings:

  • Edit Link Text: The text to display for the edit link (default: "Edit")
  • Full Screen Link Text: The text to display for the full screen link (default: "Full Screen")

Usage Example

  1. Create a Mermaid diagram in your note:
```mermaid
graph TD
    A[Start] --> B{Is it working?}
    B -->|Yes| C[Great!]
    B -->|No| D[Debug]
    D --> B
```
  1. The plugin automatically adds "Edit" and "Full Screen" links below the diagram
  2. Click the "Edit" link to modify your diagram in Mermaid Live Editor
  3. Click the "Full Screen" link to view your diagram in a clean, full-screen interface

Compatibility

  • Requires Obsidian v0.15.0 or above
  • Works with all standard Mermaid diagram types supported by Obsidian

License

This project is licensed under the MIT License.

Support

If you encounter any issues or have feature requests, please file an issue on the GitHub repository.