Kanux

Kanux is a focused kanban and table view for Obsidian. Every card stays a real Markdown note in your vault, so your tasks remain searchable, linkable, portable, and editable outside the board.

Use it locally with as many boards as you need, or pair it with Sync Deck for cross-device sync, shared vaults, member assignment, and live presence.

Screenshots

Board and Table views

Organize Markdown-backed cards visually on the Board, then switch to Table for searching, filtering, sorting, and editing the same data in a structured overview.

Cards and Markdown workflow

Open a card to manage its labels, dates, Markdown description, checklists, and progress without losing access to the underlying notes.

Dates

Labels

Markdown linked to a checklist task

Filters and multiple boards

Use searchable label filters on large boards and move between independent boards directly from the Kanux interface.

Per-board customization

Customize each board independently without changing the active Obsidian theme. Backgrounds support solid colors, gradients, and local images with adjustable fitting and darkening.

Team collaboration with Sync Deck

Sync Deck adds shared vaults, member assignment, card locks, and live presence while keeping local-only Kanux usage independent.

Screenshots were captured from a clean demo vault.

Features

• Flexible boards and lists: Create multiple independent boards, organize colored lists, and reorder cards or complete lists with drag and drop.
• Board and Table views: Manage the same cards visually or through a searchable, sortable, and configurable table.
• Complete card management: Create, edit, complete, move, export, or delete cards with titles, dates, labels, members, descriptions, images, and progress information.
• Labels and dates: Use reusable colored labels, flexible display modes, start dates, due dates, ranges, and overdue indicators.
• Rich Markdown descriptions: Write and render formatted descriptions with links, lists, quotes, code, Obsidian note references, and collapsible long content.
• Images and attachments: Add, paste, resize, arrange, reorder, copy, and manage images while keeping attachments organized inside the vault.
• Checklists and tasks: Build multiple colored checklists, reorder tasks, track independent progress, assign members, and associate individual tasks with their own Markdown notes.
• Per-board appearance: Customize backgrounds, colors, spacing, typography, density, borders, shadows, animations, labels, and image fitting; save presets or copy an appearance from another board.
• Native Obsidian storage: Keep cards as normal Markdown notes with frontmatter, graph connections, automatic file discovery, external-change synchronization, and migration support.
• Productivity and accessibility: Use commands, undo supported changes, keyboard navigation, responsive layouts, visible focus states, and reduced-motion support.
• Offline-first operation: Use local boards without an account, permanent connection, or dependency on Sync Deck.
• Optional Sync Deck collaboration: Synchronize encrypted board content across devices, share vaults, assign members, display live presence, and prevent conflicting edits with card locks.

Quick start

1. Open Kanux from the ribbon or run Kanux: Open board from the command palette.
2. Create a board. New boards start with To do, Doing, and Done lists.
3. Add cards inline, then drag them between lists as work moves forward.
4. Open a card to add labels, dates, a Markdown description, images, and named checklists.
5. Switch to Table when you want a compact overview across every list.

Use Open note in the card editor whenever you want to work directly in the underlying Markdown file.

Markdown storage

Each board lives in its own readable folder:

Product Launch/
├── Product Launch.md
├── cards/
│   ├── Prepare onboarding checklist.md
│   └── Write launch announcement.md
└── attachments/

The board index keeps list order and graph links connected. Card metadata lives in frontmatter, while the description and checklist remain ordinary Markdown. The plugin folder stores the local UI state; your task content stays in the vault.

Sync across devices and teams

Kanux works fully offline and does not require an account. To sync boards, install Sync Deck, sign in, and open or create a synced vault.

Sync Deck carries the board index, cards, and attachments across your devices. New and upgraded Sync Deck vaults end-to-end encrypt those files, their paths, and the board/card identifiers used for presence and locks; account and activity metadata still remain visible to the service. In shared vaults it also provides member assignment and live presence, so teammates can see who is viewing or editing a card. Local-only Kanux usage remains unlimited.

Network, accounts, and payment

• Kanux's local board features work offline, require no account, and contain no client-side telemetry or dynamically loaded advertising. Its interface includes a link to the optional Sync Deck companion.
• Network access occurs only through the optional Sync Deck integration when Sync Deck is installed, enabled, and signed in. It is used for file synchronization, member assignment, live presence, and edit locks.
• A Sync Deck account is required for those optional online features. Its free plan may limit the number of synchronized boards; its paid plan removes that limit. Disabling cloud synchronization leaves local Kanux boards unlimited.

Local data access

• Kanux enumerates vault file paths to discover its board and card notes and to populate note and image pickers. It reads or changes file contents only when required by a board operation or an explicit user action.
• Clipboard access occurs only when the user pastes content into a card or explicitly copies an image from a card.
• PDF exports are created through Obsidian's vault API and saved inside the vault. Kanux does not use Node.js filesystem APIs to write outside the vault.

Install

Until Kanux is available in the Obsidian community plugin directory:

1. Download main.js, manifest.json, and styles.css from the latest release of this repository.
2. Put the files in:

Your Vault/.obsidian/plugins/kanux/

3. Enable Kanux in Obsidian under Settings → Community plugins.

Development

Source files live in src/. After changing them, run:

node build.js

Obsidian loads the generated main.js file.

Credits

This project originally used ismailivanov/task-deck as its base. It has since evolved into a substantially expanded implementation with a broader product direction, independent customization, and new workflows beyond the original plugin.

Credit and thanks to Ismail Ivanov for releasing the original project under the MIT License. You can support his work through Buy Me a Coffee.

License

Kanux is distributed under the GNU Affero General Public License version 3, with an additional linking exception for Obsidian and the Obsidian Plugin API.

Portions derived from the original ismailivanov/task-deck project retain their original MIT copyright and permission notice in LICENSES/MIT-upstream.txt. See NOTICE for attribution details.