Skip to content

notesynchelper/save2obsidian

Repository files navigation

Save2Vault

Save2Vault (by Save2Obsidian) turns posts and threads from X into clean Markdown notes in your Obsidian vault.

Mention @save2obsidian in a reply under any post on X. The Save2Obsidian service prepares the post or thread, and this plugin pulls it into your vault the next time you sync.

How to use

  1. Install and enable Save2Vault in Obsidian.
  2. Get your API key from save2obsidian.com/dashboard.
  3. Open Settings → Save2Vault and paste the key.
  4. Choose a destination folder and, if desired, customize the file name, frontmatter, and note templates.
  5. Mention @save2obsidian under a post on X.
  6. Select the ribbon icon or run Save posts from X from the command palette.

Optional automatic sync can run every 5, 15, 30, or 60 minutes. You can also enable deletion from the service after each note has been written successfully.

Templates

File name, frontmatter, and note templates use Mustache syntax. Common variables include title, author, content, originalUrl, savedAt, siteName, and labels. The frontmatter field save2obsidian_id is always added so repeated syncs do not create duplicate notes.

Privacy

The plugin sends your API key and sync requests only to api.save2obsidian.com. It does not use analytics, advertising, third-party relays, or a separate update service. Returned Markdown is written directly to your vault. The plugin does not download remote images or attachments; any remote links already present in a post remain links in the saved Markdown.

Updates are delivered through the Obsidian community plugin store or GitHub releases.

Development

npm install
npm run build

The build command type-checks the source and creates main.js with esbuild. Release assets consist of main.js, manifest.json, and styles.css.

License

MIT

About

Save posts and threads from X into your Obsidian vault as clean markdown notes

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors