sophokles187_data-cards/docs/getting-started.md

Getting Started with DataCards

Table of contents

• Installation
  • Requirements
  • Installation Methods
• Basic Usage
• Your First DataCards Block

Installation

Requirements

• Obsidian v0.15.0+
• Dataview Plugin

Installation Methods

Method 1: Community Plugins

Note

: DataCards is not yet available in the Community Plugins store. Please use BRAT or manual installation until then.

1. Open Obsidian Settings
2. Go to Community Plugins
3. Click "Browse" and search for "Data Cards"
4. Click "Install", then "Enable"

Method 2: BRAT Plugin

1. Install the BRAT plugin through Community Plugins
2. Open BRAT settings in Obsidian
3. Click "Add Beta Plugin"
4. Enter the DataCards repository URL: https://github.com/Sophokles187/data-cards
5. Click "Add Plugin"
6. Enable DataCards in Community Plugins settings

Method 3: Manual Installation

1. Download the latest release from the releases page
2. Download these files:
   • main.js
   • manifest.json
   • style.css
3. Navigate to your Obsidian vault's .obsidian/plugins/ directory
4. Create a new folder named data-cards
5. Copy the downloaded files into the data-cards folder
6. Enable the plugin in Obsidian's Community Plugins settings

Basic Usage

Create a datacards code block with a Dataview query:

```datacards
TABLE author, rating, genre FROM #books
SORT rating DESC

This will automatically render the results as cards using the default settings.

## Your First DataCards Block

1. Make sure both Dataview and DataCards plugins are enabled
2. Create a new note or open an existing one
3. Start a new code block with three backticks followed by `datacards`
4. Write a Dataview query
5. End the code block with three backticks
6. Preview your note to see the cards

That's it! Your Dataview results will now display as beautiful cards.