Obsidian Stats logoObsidian Stats

CleanShot Embed

by janacm
5
4
3
2
1
Score: 35/100
Install Code

Description

This plugin has not been manually reviewed by Obsidian staff. Renders CleanShot share URLs as inline images by fetching fresh signed URLs at render time.

Reviews

No reviews yet.

Stats

stars
8
downloads
0
forks
1
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

See all version on GitHub

README file from

Github

CleanShot Embed

An Obsidian plugin that renders CleanShot share URLs (cln.sh/XXX) as inline images in reading view.

Why?

CleanShot share URLs are permanent, but they link to a landing page — not a direct image. The direct image URL is a signed CloudFront URL that expires. Downloading images locally wastes your Obsidian Sync storage quota.

This plugin fetches a fresh signed URL at render time and displays the image inline. No files are stored in your vault.

How it works

  • MarkdownPostProcessor intercepts rendered HTML in reading view, finds CleanShot links, and replaces them with <img> elements.
  • requestUrl from the Obsidian API fetches the CleanShot share page (bypasses CORS).
  • Extracts the signed image URL from the page's embedded JSON data.
  • In-memory cache avoids refetching the same URL on re-renders. Cleared on plugin unload.
  • Graceful fallback — if the fetch fails, shows the original URL as a clickable link.

Usage

  1. Paste a CleanShot share URL (e.g. https://cln.sh/LQtyfqN5) into any note
  2. Switch to Reading View — the URL renders as an inline image
  3. Click the image to open the original share page in your browser

Supported URL formats

  • https://cln.sh/XXXX
  • https://share.cleanshot.com/XXXX

Installation

From Community Plugins

Search for "CleanShot Embed" in Obsidian Settings > Community Plugins.

Manual

  1. Copy main.js, manifest.json, and styles.css into .obsidian/plugins/cleanshot-embed/
  2. Reload Obsidian
  3. Enable "CleanShot Embed" in Settings > Community Plugins

Notes

  • Desktop only (requestUrl CORS bypass is not available on mobile)
  • Images are never saved to your vault — zero impact on Obsidian Sync storage
  • Signed URLs are fetched fresh each session, so images continue to work even after CloudFront URLs expire
Sponsors