๐ Read this in other languages: Franรงais | Espaรฑol | Deutsch | Portuguรชs | ็ฎไฝไธญๆ | ะ ัััะบะธะน
Agile Board transforms your Obsidian notes into interactive visual boards. Your sections become editable frames arranged on a grid โ while always remaining valid, portable Markdown under the hood.
- Grid scaling: frames scale to fit the paper size (portrait or landscape) without overflowing
- Header & footer: file title at the top, plugin version at the bottom right
- Callouts: correctly styled in print output
- Obsidian Bases: cards and tables print cleanly โ toolbar stripped, dates formatted as
DD/MM/YYYY HH:MM:SS, property labels shown (except the redundant "name") - Task lists: checkboxes preserved with proper spacing
Resize handles in the layout editor stopped working after Obsidian's Chromium upgrade in v1.13.0. This patch fully restores the visual editor on all supported versions.
Previously, editing a frame required switching the whole note to edit mode, making it difficult to write while keeping the board visible.
You can now double-click any frame title to open its content in a dedicated window, with full Obsidian Live Preview. The content syncs back automatically when the window is closed. Locked frames cannot be opened in popout.
- Two display modes: switch freely between the visual board (๐ข) and classic Markdown editing (๐)
- Editable frames: click any frame to enter edit mode with CodeMirror 6
- Popout editor: double-click a frame title to edit in a separate window โ keep the board visible while writing
- Smart editing: auto-continued lists and callouts, clickable checkboxes with instant sync
- Rich Markdown:
[[links]],- [ ] tasks, formatting, code blocks, horizontal rules
- Frame lock: lock a frame to prevent accidental edits โ links, embeds and checkboxes still work when locked
- Font size: adjust text scale across all frames (0.7ร to 1.5ร) from plugin settings
- Custom colors: assign a color to any frame โ tinted title bar and colored border in the board view
- Images:
![[image.png]]renders correctly in board preview - Notes:
![[other-note.md]]embeds the note content directly in the frame - Obsidian Bases:
![[table.base]]displays interactive database views; use![[table.base#ViewName]]to remember the selected view - Dataview & Tasks: queries render and update normally inside frames
- Context menu & print: right-click the board tab for all standard Obsidian options, plus direct board printing
The frame editor uses CodeMirror 6 but does not replicate every Obsidian editing feature:
- Link suggestions: typing
[[does not suggest your notes โ type the full link manually - Inline plugin calls: inline Dataview queries (
= this.file.name) and Templater commands (<% tp.date.now() %>) do not execute inside frames - Desktop only: boards are not available on mobile โ your notes remain readable as standard Markdown on mobile
Requirements: Obsidian desktop โฅ 0.15.0. Compatible with Obsidian 1.13.0 (Catalyst) and later.
BRAT handles automatic updates:
- Install and enable the BRAT community plugin
- In BRAT settings, add
a198h/agile-board - BRAT installs the plugin and keeps it up to date automatically
- Download
main.js,manifest.jsonandstyles.cssfrom the latest GitHub release - Copy the three files to
.obsidian/plugins/agile-board/ - Restart Obsidian and enable Agile Board in Settings โ Community plugins
5 default layouts are bundled with the plugin โ no additional download required.
Add the agile-board property to the note's frontmatter:
---
agile-board: eisenhower
---Click the ๐ข icon in the toolbar to switch to Board mode.
| Layout | Description |
|---|---|
eisenhower |
Important / Urgent 4-quadrant matrix |
swot |
Strengths, Weaknesses, Opportunities, Threats |
moscow |
Must / Should / Could / Won't prioritization |
effort_impact |
Action prioritization by effectiveness |
cornell |
Active note-taking system |
- Single click โ edit mode
- Double-click the title โ open in popout window
- Changes are saved to the Markdown file automatically
Open Settings โ Community plugins โ Agile Board to manage layouts and appearance.
Each layout is a .json file in the plugin's layouts/ folder. From the settings panel:
| Action | Control |
|---|---|
| Create | โ button โ enter a name |
| Edit | โ๏ธ icon โ opens the visual editor |
| Duplicate | ๐ icon |
| Export / Import | โฌ๏ธ / โฌ๏ธ icons โ share or load configurations |
| Delete | ๐๏ธ icon |
The editor shows a 24ร24 grid where you place and resize boxes (frames):
- Create: click and drag on an empty area
- Move: drag a box to reposition it
- Resize: drag the circular handles at the box corners and edges
- Rename: edit the title in the side panel
- Color: pick a custom color from the side panel โ click Reset to revert to the palette color
- Delete: ๐๏ธ button in the side panel
- Clear all: removes all boxes from the layout (with confirmation)
Each box maps to a level-1 heading (#) in the note and the content that follows it.
The interface automatically adapts to your Obsidian language. All UI elements, settings, messages and tooltips are available in 7 languages (96 translation keys):
| Language | Status |
|---|---|
| ๐บ๐ธ English | reference |
| ๐ซ๐ท Franรงais | complete |
| ๐ช๐ธ Espaรฑol | complete |
| ๐ฉ๐ช Deutsch | complete |
| ๐ต๐น Portuguรชs | complete |
| ๐จ๐ณ ไธญๆ (็ฎไฝ) | complete |
| ๐ท๐บ ะ ัััะบะธะน | complete |
This plugin is inspired by Obsidian-Templify and builds on the idea of transforming Markdown notes into visual layouts.
- Bug reports & feature requests: GitHub Issues
- Discussions: GitHub Discussions
If you find this plugin useful, consider supporting development:
