# Obsidian Dataview Serializer

Obsidian plugin that gives you the power of [Dataview](https://github.com/blacksmithgu/obsidian-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.

## Pre-requisites

The [Dataview](https://github.com/blacksmithgu/obsidian-dataview) plugin MUST be installed for this plugin to function correctly.

Obsidian **1.8.7 or later** is required.

## Installation

### Community plugins (recommended)

1. In Obsidian, go to **Settings → Community plugins**.
2. Disable **Restricted mode** if it's enabled.
3. Select **Browse**, search for **Dataview Serializer**, install it, then enable it.

You can also browse the catalog on the [Obsidian Community](https://community.obsidian.md/) website.

### Manual installation

If the plugin isn't listed in the community catalog yet (or you want a specific version):

1. Download `main.js`, `manifest.json`, and `styles.css` from the [latest release](https://github.com/dsebastien/obsidian-dataview-serializer/releases).
2. Copy them into `<Vault>/.obsidian/plugins/dataview-serializer/`.
3. Reload Obsidian and enable **Dataview Serializer** in **Settings → Community plugins**.

### BRAT (bleeding edge)

[BRAT](https://github.com/TfTHacker/obsidian42-brat) (Beta Reviewers Auto-update Tool) installs plugins straight from a GitHub repo and keeps them updated automatically. Use this if you want the latest commits — **things might break**.

1. Install **Obsidian42 - BRAT** from **Settings → Community plugins → Browse** and enable it.
2. Run **BRAT: Add a beta plugin for testing** from the command palette.
3. Paste `https://github.com/dsebastien/obsidian-dataview-serializer`.
4. Select the latest version and confirm.
5. Enable **Dataview Serializer** in **Settings → Community plugins**.

## Documentation

You can find the documentation [here](https://developassion.gitbook.io/obsidian-dataview-serializer).

## News & support

To stay up to date about this plugin, Obsidian in general, Personal Knowledge Management and note-taking, subscribe to [my newsletter](https://dsebastien.net/newsletter). If you want to support my work, then you can [check out my products](https://store.dsebastien.net), or [become a GitHub Sponsor](https://github.com/sponsors/dsebastien).