Open app
margin.at · Annotation Exporter

View and export
your annotations

A lightweight, open-source tool for browsing your margin.at highlights, annotations, and bookmarks — and downloading them in a format you can actually use.

What is this?

margin.at is a browser extension that lets you annotate, highlight, and bookmark anything on the web. It stores all your data on the AT Protocol — the same open infrastructure that powers Bluesky — meaning your annotations belong to you.

This exporter connects directly to your personal data server (PDS) using your AT Protocol credentials, fetches your records, and gives you a clean interface to browse and download them. No middleman. No server-side storage. Everything runs in your browser.

What you can do

📚

Browse collections

Navigate all your margin.at collections from the sidebar and view individual annotations.

🔍

Filter by type

Quickly filter between annotations, highlights, and bookmarks within any collection.

📤

Export collections

Download any collection in JSON, CSV, Markdown, or a clean "beautified" format.

💾

Full account backup

Use "Export all" to download every annotation, highlight, and bookmark at once as a CSV.

🔐

Credentials cached

Your handle and app password are saved locally so you don't have to re-enter them each visit.

🌐

Any PDS supported

Works with any AT Protocol PDS — bsky.social or self-hosted. Auto-detected from your handle.

Getting started

1

Get an app password

Go to bsky.app/settings/app-passwords and create a new app password. Give it a name like "margin exporter". Copy it — you'll only see it once.

2

Sign in on the app

Enter your AT Protocol handle (e.g. yourname.bsky.social) and the app password you just created. Press Connect.

3

Browse your collections

Once signed in, your margin.at collections appear in the left sidebar. Click any collection to load its annotations in the main panel.

4

Filter by type

Use the filter pills at the top of the main panel to show only annotations, highlights, or bookmarks within the selected collection.

5

Export a collection

Click the Export button in the toolbar to download the current collection. Choose from JSON, CSV, Markdown, or Beautified format.

6

Back up everything

Click Export all in the header to download every annotation, highlight, and bookmark in your entire account as a single CSV file.

What each format gives you

.json
JSON
Full structured data including all fields. Best for developers or importing into other tools programmatically.
.csv
CSV
Flat table with columns for URL, title, quote, note, tags, type, and date. Opens directly in Excel, Numbers, or Google Sheets.
.md
Markdown
Full notes with formatted headings, blockquote-style quotes, metadata (type, date, source link), and tags. Great for Obsidian, Notion, or any Markdown app.
.md
Beautified
Just the quotes and notes — no metadata, no clutter. Clean reading experience. Perfect for a personal reading digest or sharing.

How your data is handled

🔒

Everything runs in your browser. Your credentials and annotation data never leave your device or pass through any server we control. The app talks directly to your AT Protocol PDS. Your app password is stored only in your browser's localStorage and can be cleared at any time by clicking Sign out.

Built in the open

This tool is a single HTML file with no build tooling, no dependencies, and no tracking. You can inspect every line of code, host your own copy, or contribute improvements.

View the source on GitHub →

Made with AI  ·  About  ·  GitHub