How X-TOC works

Read with structure. Keep useful context.

X-TOC, also written as xtoc, is an open-source browser extension for X (Twitter) Articles. It adds a table of contents and lets you save passages locally with tags and notes, then export them as Markdown or JSON.

Use the extension

From article to saved clip

1. Open a supported article

Visit a long-form article on X.com or Twitter.com. X-TOC detects headings when the article provides them.

2. Navigate its headings

Open the extension popup for the current outline. Pin the floating contents panel when you want the structure beside the article; drag or resize it to fit your reading space.

3. Save a passage

Select useful article text and choose Save to X-TOC. The passage is stored with its article, timestamp, surrounding context, and author when available.

4. Open Saved clips

Choose Saved clips in the extension popup. Search your library, add tags or notes, delete clips, and select the passages you want to export.

Organize and export

A small library, built for useful passages

Search what you saved

Search across clip text, article titles, authors, tags, and notes. Clips stay grouped with their source article.

Add tags and notes

Attach tags for retrieval and a note for the reason the passage mattered. Older clips without these optional fields remain supported.

Export Markdown or JSON

Export every clip or select only the passages you need. Exports are local, user-triggered downloads.

Keep clip data local

Saved clips, tags, notes, and settings remain in browser extension storage. X-TOC does not upload saved clips.

Current boundaries

What X-TOC does today

X-TOC works on supported X.com and Twitter.com long-form articles. Heading navigation depends on headings being present in the article.

Saved passages are available in the extension’s Saved clips page. X-TOC does not restore highlights inside the original article, sync clips to a cloud service, or capture arbitrary web pages.

Common questions

Before you start

Does it work on every X post?

No. X-TOC works on supported long-form X/Twitter articles. A table of contents needs headings in the article; it does not turn ordinary posts into structured articles.

How do I open the table of contents?

Open an article, then select X-TOC in Chrome’s extensions menu. Open the outline in the popup and pin the floating panel to keep it beside the article.

Where do my clips go?

The extension keeps clips, tags, and notes in local browser storage. It does not upload saved clips or sync them between devices. Use Markdown or JSON export to keep a separate copy.

Is this website my clip library?

No. This website uses sample content for its interactive demo. Your actual library is in the extension’s Saved clips page.