X/Twitter Post Embed

by mathieulohr
5
4
3
2
1
New Plugin

Description

This plugin has not been manually reviewed by Obsidian staff. Automatically embeds X (formerly Twitter) post text when pasting a URL. Also saves posts as notes via command palette.

Reviews

No reviews yet.

Stats

stars
downloads
0
forks
0
days
NaN
days
NaN
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
0
commits

Latest Version

Invalid date

Changelog

README file from

Github

X/Twitter Post Embed

An Obsidian plugin that automatically embeds X (formerly Twitter) post text when you paste a URL. Also saves posts as individual notes via the command palette.

Features

  • Auto-embed on paste — paste a tweet URL and it's replaced with formatted text
  • Full thread support — captures entire tweet threads, not just the first post
  • Multiple formats — blockquote, callout, or plain text
  • Save as note — save tweets as individual markdown files
  • Author pages — automatically creates per-author aggregation pages with transclusion
  • Rich metadata — optionally includes date, media, engagement metrics, community notes, and author bio
  • Translation — fetch tweets in a chosen language via FxTwitter (defaults to English; blank to disable)
  • Quote tweet support — nested formatting for quoted tweets
  • Parse existing links — command to retroactively parse bare tweet URLs in a note

Installation

From Obsidian Community Plugins

  1. Open Settings > Community Plugins
  2. Search for "X/Twitter Post Embed"
  3. Click Install, then Enable

Manual Installation

  1. Download main.js, manifest.json, and styles.css from the latest release
  2. Create a folder x-twitter-post-embed in your vault's .obsidian/plugins/ directory
  3. Copy the downloaded files into that folder
  4. Enable the plugin in Settings > Community Plugins

Usage

Paste a tweet URL into any note — the plugin intercepts the paste and replaces the URL with the formatted tweet text.

Save a tweet as a note using the command palette (Cmd/Ctrl+P) > "Save X Post", or click the Twitter icon in the ribbon.

Parse existing links via the command palette > "Parse unparsed tweet links" to convert bare tweet URLs already in your notes.

Settings

Setting Description Default
Tweets folder Where saved tweet notes are stored Tweets
Author pages Create per-author aggregation pages Off
Paste format Blockquote, callout, or plain Blockquote
Auto-embed on paste Automatically replace pasted URLs On
Save on paste Also save a note when pasting Off
Include date Show tweet date/time On
Include media Embed images from tweets On
Include metrics Show likes, reposts, etc. Off
Include community notes Show community notes On
Include author bio Show author description/followers Off
Translate tweets to language ISO code (e.g. en) for FxTwitter translation; blank disables en

Network Usage

This plugin makes requests to external services to fetch tweet data. No user data is sent beyond the tweet ID being fetched.

Service Domain Purpose
FxTwitter API api.fxtwitter.com Primary source for tweet text, threads, and metadata
Twitter oEmbed publish.twitter.com Fallback if FxTwitter is unavailable

Credits

Inspired by x-post-saver by tanaka-mambinge, which provided the initial concept and project scaffolding for saving X posts in Obsidian.

License

MIT