https://github.com/deathau/csv-obsidian

Edit CSV Files in Obsidian
https://github.com/deathau/csv-obsidian

Last synced: 28 days ago
JSON representation

Edit CSV Files in Obsidian

• Host: GitHub
• URL: https://github.com/deathau/csv-obsidian
• Owner: deathau
• Created: 2021-01-28T06:40:21.000Z (about 4 years ago)
• Default Branch: main
• Last Pushed: 2022-04-11T07:37:57.000Z (about 3 years ago)
• Last Synced: 2025-03-16T10:51:15.267Z (29 days ago)
• Language: TypeScript
• Size: 198 KB
• Stars: 119
• Watchers: 10
• Forks: 7
• Open Issues: 13
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml

Awesome Lists containing this project

• jimsghstars - deathau/csv-obsidian - Edit CSV Files in Obsidian (TypeScript)

README

        
# CSV Editor Obsidian Plugin

[![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/deathau/csv-obsidian?style=for-the-badge&sort=semver)](https://github.com/csv-obsidian/releases/latest)

![GitHub All Releases](https://img.shields.io/github/downloads/deathau/csv-obsidian/total?style=for-the-badge)

A plugin for [Obsidian](https://obsidian.md) which allows viewing and editing of CSV files in a spreadsheet-like table format.  

**Back up your CSV files!** This plugin is very new and therefore experimental. At this stage, data loss is a very real possibility!

![Screenshot](https://github.com/deathau/csv-obsidian/raw/main/screenshot.png)

### Features

- Open (and edit) CSV files right from Obsidian!

- Auto-saving

- Per-file setting for including headers (persisted in local storage)

- Markdown editing an preview for each individual cell (internal links aren't working correctly, yet)

- Sort the data by clicking on a column name

- Filter by column values

- Freeze columns

- Insert new columns/rows

## Installation

### From GitHub

- Download the latest master

- Extract the files from the zip to your vault's plugins folder: `/.obsidian/plugins/ini-obsidian`  

Note: On some machines the `.obsidian` folder may be hidden. On MacOS you should be able to press `Command+Shift+Dot` to show the folder in Finder.

- Reload Obsidian

- If prompted about Safe Mode, you can disable safe mode and enable the plugin.

Otherwise head to Settings, third-party plugins, make sure safe mode is off and

enable the plugin from there.

## Development

This project uses Typescript to provide type checking and documentation.  

The repo depends on the latest [plugin API](https://github.com/obsidianmd/obsidian-api) in Typescript Definition format, which contains TSDoc comments describing what it does.

**Note:** The Obsidian API is still in early alpha and is subject to change at any time!

If you want to contribute to development and/or just customize it with your own

tweaks, you can do the following:

- Clone this repo.

- `npm i` or `yarn` to install dependencies

- `npm run build` to compile.

- Copy `manifest.json`, `main.js` and `styles.css` to a subfolder of your plugins

folder (e.g, `/.obsidian/plugins//`)

- Reload obsidian to see changes

Alternately, you can clone the repo directly into your plugins folder and once

dependencies are installed use `npm run dev` to start compilation in watch mode.  

You may have to reload obsidian (`ctrl+R`) to see changes.

## Pricing

Huh? This is an open-source plugin I made *for fun*. It's completely free.

However, if you absolutely *have* to send me money because you like it that

much, feel free to throw some coins in my hat via

[PayPal](https://paypal.me/deathau) or sponsor me via

[GitHub Sponsors](https://github.com/sponsors/deathau)

# Version History

## 0.0.1

Initial release of csv-obsidian! See [Features](#Features) above