gitwtfhub

wtf is obsidian-social-deck?

torin-cyber-group/obsidian-social-deck — explained in plain English

Analysis updated 2026-07-25

0TypeScriptAudience · generalComplexity · 3/5Setup · moderate

TL;DR

An Obsidian plugin that lets you write social media posts as notes and send them to n8n for automated publishing to Bluesky and LinkedIn. You compose in Obsidian, n8n handles delivery, scheduling, and credentials.

Mindmap

mindmap
  root((repo))
    What it does
      Compose posts in Obsidian
      Sends to n8n via webhook
      Character counts per platform
      Sidebar for writing
    Supported platforms
      Bluesky text posts
      LinkedIn profiles and pages
      X Twitter planned
      Images planned
    Setup
      Install plugin in vault
      Import n8n workflows
      Configure platform credentials
      Secure webhook with token
    Tech stack
      TypeScript
      Obsidian API
      n8n workflows
    Use cases
      Write and schedule posts
      Manage social credentials safely
      Post to multiple platforms
    Limitations
      Text only for now
      No image uploads yet
      No link preview cards
      No threaded posts yet

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Write social media posts inside Obsidian and publish them to Bluesky and LinkedIn without leaving your notes app.

REASON 2

Manage all your social media credentials securely in n8n instead of pasting them into multiple tools.

REASON 3

Schedule and retry social posts automatically through n8n workflows.

REASON 4

Post to LinkedIn as either a personal profile or an organisation page from within Obsidian.

What's in the stack?

TypeScriptObsidian APIn8n

How it stacks up

torin-cyber-group/obsidian-social-deck0xkinno/astraea0xkinno/halcyon
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardhard
Complexity3/54/54/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires both a self-hosted n8n instance and platform-specific credentials (Bluesky app password, LinkedIn OAuth2) configured separately.

Wtf does this do

Obsidian Social Deck is a plugin for Obsidian, the popular note-taking app. It lets you write social media posts inside Obsidian and then send them to an automation tool called n8n, which handles the actual publishing. The idea is that you compose your post in a familiar writing environment, and n8n takes care of delivering it to platforms like Bluesky and LinkedIn. The plugin adds a sidebar in Obsidian where you can paste your post text and see character counts for each platform. When you are ready, the plugin sends the post to a self-hosted n8n instance through a secure webhook connection. n8n acts as the middleman: it stores your social media credentials, manages scheduling and retries, and talks to each platform's API. The recommended setup uses a main router workflow in n8n that calls separate sub-workflows for each platform. Right now, text-only publishing to Bluesky and LinkedIn is available. The Bluesky workflow supports creating posts with URL link facets, meaning links in your post text get properly formatted. LinkedIn publishing works for both personal profiles and organisation pages. The README notes that X/Twitter publishing, image uploads, link preview cards, and threaded posts are planned but not yet implemented. Setup requires two parts. First, you install the plugin files in your Obsidian vault and enable it. Second, you import workflow files into n8n and configure credentials for each platform. For Bluesky, you need your handle and a dedicated app password, not your main account password. For LinkedIn, n8n uses OAuth2 authentication, and you select whether to post as a person or an organisation directly in n8n. The connection between Obsidian and n8n is secured with a shared secret token. The project is in active development. The README is detailed about the current workflow and credentials setup, and it is honest about what is not finished yet.

Yoink these prompts

Prompt 1
Help me set up the Obsidian Social Deck plugin in my vault and connect it to my self-hosted n8n instance via webhook.
Prompt 2
Write an n8n router workflow that receives posts from Obsidian Social Deck and calls separate sub-workflows for Bluesky and LinkedIn publishing.
Prompt 3
Help me configure Bluesky credentials in n8n using my handle and a dedicated app password for the Obsidian Social Deck workflow.
Prompt 4
Generate a post template in Obsidian optimized for both Bluesky and LinkedIn character limits using the Social Deck sidebar.

Frequently asked questions

wtf is obsidian-social-deck?

An Obsidian plugin that lets you write social media posts as notes and send them to n8n for automated publishing to Bluesky and LinkedIn. You compose in Obsidian, n8n handles delivery, scheduling, and credentials.

What language is obsidian-social-deck written in?

Mainly TypeScript. The stack also includes TypeScript, Obsidian API, n8n.

How hard is obsidian-social-deck to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is obsidian-social-deck for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.