Export

Export renders the knowledge base to an external format via the exporter registry.

Obsidian

particles.exporters.obsidian.export_vault(session, output_dir, min_particles=0, min_links=1, with_synthesis=False, min_particle_confidence=0.0, invalidate_stale_links=False, include_non_asserted=False) async

Export the particle store as an Obsidian vault.

Creates one .md file per Subject plus a _index.md overview. Only subjects with at least min_particles particles and min_links graph links (outgoing + incoming combined) are written. Returns an :class:ObsidianSummary.

When with_synthesis is True, each per-subject note additionally carries the LLM-synthesised prose article above its existing structural particle listing. The synthesis machinery lives in :mod:particles.render.article_synthesis and is shared with the WikiExporter; per-subject input-hash caching means an operator who runs both exports against the same store pays LLM cost once per Subject.

min_particle_confidence: drop particles whose effective_confidence falls below this threshold from every rendered note — coin-property tables, pivot-note callouts, generic subject-note audit trails, and the --with-synthesis splice all consume the post-filter list. Default 0.0 keeps every existing invocation backwards-compatible. The min_particles count check runs against the filtered set per the cross-exporter contract, so a subject with too few high-confidence particles is suppressed rather than rendered as a thin note.