Skip to content

1.0.0

Choose a tag to compare

@github-actions github-actions released this 17 Aug 04:01
· 17 commits to main since this release

First public release.

Mosaic turns a plain-text declaration in your note into a chart, table, timeline or diagram — rendered in place, with no external service and no change to your source file.

Six block types

Each one can be written as a tag or as a code block, with an identical attribute contract either way:

Block What it does
Chart Line, bar, grouped bar, stacked bar, combo and dual-axis charts
DataTable Sortable data table with automatic column layout
MetricGrid Status-colored metric cards in an adaptive grid
Timeline Vertical timeline with status-colored milestones
DecisionBox Structured decision record, with a free-text fallback that never errors
FlowDiagram Auto-layout flow diagram (SVG)

Data comes from inline CSV, JSON or a Markdown table. Chart and DataTable additionally read an external .dataset.json manifest, with time-range filtering and granularity roll-up.

A malformed block renders one inline error box with the exact line range; the rest of the note is unaffected.

Requirements

  • Obsidian 1.13.0 or later
  • Blocks render in reading view — Live Preview is on the roadmap
  • Works in both .md and .mdx

Install manually

Download main.js, manifest.json and styles.css below into <vault>/.obsidian/plugins/mosaic/, then enable Mosaic in Settings → Community plugins.

Privacy

No network requests, no telemetry, no account, no ads, no code execution. Dataset files are resolved relative to the referencing note and read through Obsidian's own vault API — nothing leaves your vault.

Documentation

README · 中文说明 · Per-block guides