README file from
GithubGoban Viewer
Goban Viewer renders Go/Baduk/Weiqi diagrams in Obsidian using Sensei's Library diagram syntax.
Write a diagram inside a fenced goban code block and the plugin will render it as an SVG goban directly in your note.
Features
- Render Sensei's Library-style Go diagrams in Obsidian notes.
- Supports fenced code blocks using the
gobanlanguage. - Outputs lightweight SVG diagrams.
- Works on desktop and mobile Obsidian.
The plugin is currently very experimental and offers limited customization options. But they will come in the future. :)
Installation
From Obsidian Community Plugins
- Open Settings → Community plugins in Obsidian.
- Disable Restricted mode, if needed.
- Click Browse.
- Search for Goban Viewer.
- Install and enable the plugin.
Manual installation
- Download
main.js,manifest.json, andstyles.cssfrom the latest release. - Create the folder
.obsidian/plugins/goban-viewer/inside your vault, if it does not already exist. - Copy the downloaded files into that folder.
- Reload Obsidian.
- Enable Goban Viewer from Settings → Community plugins.
Usage
Create a fenced code block with the goban language and write the board position using Sensei's Library diagram notation.
```goban
$$c Links in diagrams - examples
$$ --------------
$$ | . . . . 1 . .
$$ | . C . . . . .
$$ | 2 . . X O 4 .
$$ | . . X O . . .
$$ | . . X O . . .
$$ | 3 . a . . C .
$$ | . . . . . . .
$$ [2|NadareJoseki]
$$ [a|http://gtl.xmp.net/members/info?p_key=349&pseudo=dada]
$$ [C|#1]
```
You should get something like this:
For the full diagram syntax, see How Diagrams Work on Sensei's Library.
Limitations
Goban Viewer uses a renderer derived from an older Sensei's Library diagram conversion script. Most common diagrams should work, but some less common markup may be incomplete or behave differently from Sensei's Library.
If you find a diagram that does not render correctly, please open an issue with the original diagram text and the expected output.
Development
Install dependencies:
npm install
Run a development build with watch mode:
npm run dev
Create a production build:
npm run build
The Obsidian plugin entry point is generated as main.js in the repository root.
License
This project is licensed under the GNU General Public License v3.0. See LICENSE for details.