Every Obsidian Canvas card carries an optionalDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/redsheep913/Canvas-Card-Materializer/llms.txt
Use this file to discover all available pages before exploring further.
color property — an integer string from "0" to "6" that controls the card’s visual tint in the canvas UI. Canvas Card-Materializer reads this property at materialization time and uses it to automatically route the generated .md file into a named sub-folder, giving your vault a consistent, color-coded directory structure with zero manual filing.
Color-to-Folder Mapping
The plugin’scolorFolderMap in main.ts defines the following routing table:
| Color Code | Canvas Color | Folder Name |
|---|---|---|
"0" | Grey (no color) | Default |
"1" | Red | Red |
"2" | Orange | Orange |
"3" | Yellow | Yellow |
"4" | Blue | Blue |
"5" | Green | Green |
"6" | Purple | Purple |
ensureFolderExists() before writing each file, so only folders that are actually needed are created in your vault.
Folder Path Formula
Every materialized file lands at:.canvas file sits at the vault root, there is no <canvas-parent-dir> segment and the path becomes <canvas-name>/<ColorFolder>/<filename>.md.
| Segment | Source |
|---|---|
<canvas-parent-dir> | The directory containing the .canvas file (omitted when canvas is at vault root) |
<canvas-name> | The basename of the .canvas file (no extension) |
<ColorFolder> | The folder name from colorFolderMap matching the node’s color value |
<filename>.md | The sanitized, truncated first line of the card’s text |
Concrete Example
Suppose you have a canvas atDocuments/Project-ASR.canvas and you materialize a yellow card (color: "3") whose first line reads Sprint Goals.
The plugin resolves:
<canvas-parent-dir>→Documents<canvas-name>→Project-ASR<ColorFolder>→Yellow(because color code"3"maps toYellow)<filename>→Sprint Goals
color: "1") from the same canvas named Blockers would land at:
If a card has no
color property set, the plugin defaults to color code "0", routing the file into the Default sub-folder. This ensures every materialized note always has a well-defined home, even if you haven’t assigned colors to your cards.