Overview

Welcome to the official documentation of the Dataview Serializer plugin for Obsidian.

This plugin gives you the power of Dataview, but generates Markdown. Thanks to this, the output of your queries is saved in the notes, and the links actually appear on the Graph, making it even more useful.

Turning Dataview queries into Markdown also ensures that the generated content appears on Obsidian Publish websites, which is not the case with the Dataview plugin.

Features

• Automatic serialization: Dataview queries are automatically serialized to Markdown when files are saved

• Block queries: Support for LIST, TABLE, and TASK queries

• Inline expressions: Support for inline Dataview expressions like =this.name, =this.file.ctime, =embed(this.portrait)

• Per-query update control: Control when individual queries update using different query types (auto, manual-only, or write-once)

• Inline refresh button: Refresh individual queries directly from the editor

• Force update folders: Configure specific folders (like index files) to update when any file in your vault changes

• Idempotency protection: Prevents unnecessary file modifications and infinite update loops

• Manual mode: Option to disable automatic updates and only serialize queries on demand

• Command palette integration: Commands to serialize all queries, current file queries, or insert new query blocks

Currently, this plugin supports:

• Block queries: LIST, TABLE, and TASK queries. CALENDAR queries are not supported.

• Inline expressions: Any valid Dataview inline expression (e.g., =this.field, =embed(this.link)).

Note: TASK queries have their checkbox markers stripped in the serialized output to prevent feedback loops. The result will be a regular list instead of a task list. See the Usage documentation for details.

About

This plugin is an open source project, created by Sébastien Dubois.

Sebastien is a Knowledge Management expert, and community founder. You can find his newsletter here. Sebastien has also created the Obsidian Starter Kit, a popular template for Obsidian, as well as various projects, products and courses.