Trello to Obsidian Kanban Conversion
Convert TRELLO_IMPORT/ board directories into Obsidian Kanban plugin board files.
Each Trello list becomes a Kanban column, and each Trello card becomes a linked card
in the board.
Prerequisites
- The
trello-importskill must have been run first to produce theTRELLO_IMPORT/<Board>/<List>/<Card>/index.mddirectory structure. - For details on the Kanban board file format, consult the
obsidian-kanbanskill.
Bundled Script
The conversion script is at scripts/trello_to_kanban.py. Run from the repository root:
# Convert a specific board
python3 .claude/skills/trello-convert-obsidian-kanban/scripts/trello_to_kanban.py "Foodie"
# Convert all imported boards
python3 .claude/skills/trello-convert-obsidian-kanban/scripts/trello_to_kanban.py
# Custom output directory
python3 .claude/skills/trello-convert-obsidian-kanban/scripts/trello_to_kanban.py -o KANBAN/ "Foodie"
Behavior
- Reads
TRELLO_IMPORT/<Board>/and finds list directories (folders matchingNNN namepattern) - Sorts lists by their zero-padded prefix (preserving Trello board order)
- Strips the numeric prefix from column names (
001 Ausprobieren-Ideen->Ausprobieren-Ideen) - Creates
- [ ] [[path/to/card/index]]wiki-link items for each card that has anindex.md - Cards are sorted alphabetically within each column
- Adds
***separator and## Archivesection - Appends
%% kanban:settings ... %%block withkanban-plugin: board - Output defaults to
TRELLO_IMPORT/<Board>/<Board> Kanban.md - Skips boards where the output file already exists (delete to regenerate)
Output Format
The generated file matches the exact format expected by the Obsidian Kanban plugin:
- Frontmatter:
kanban-plugin: board(with blank lines around the property) - Columns:
## H2headings - Cards:
- [ ] [[TRELLO_IMPORT/Board/List/Card/index]]wiki-links - Double blank lines between columns
***before## Archive- Settings block with plain triple backticks (no language hint)
For the complete Kanban format specification, refer to the obsidian-kanban skill.
Verify
After running the script, open the generated .md file in Obsidian. It should render
as a Kanban board with columns matching the original Trello lists and linked cards.
# Quick check
head -30 "TRELLO_IMPORT/Foodie/Foodie Kanban.md"