X Article Saver

A Chrome extension that saves articles, posts, and videos from X.com (Twitter) and any website as clean markdown files, optimized for Obsidian.

Save your favorite content from X.com and the web directly to markdown format, perfect for your Obsidian vault or any markdown-based knowledge management system.

Features

• Save X.com Content: Posts, long posts, threads, and articles from X.com/Twitter
• Save X.com Videos: Detects video posts and includes video metadata
• Save Web Articles: Articles from any website with structured content extraction
• Clean Markdown Export: Academic-style format optimized for Obsidian
• Obsidian-Compatible Filenames: Title - YYYY-MM-DD.md

Why Use This?

• 📝 Knowledge Management: Build your personal knowledge base from web content
• 🔗 Obsidian Integration: Filenames and format designed for Obsidian vaults
• 🎯 X.com Specialization: Advanced extraction for tweets, threads, and X articles
• 📹 Video Support: Captures video metadata from X.com posts
• 🌐 Universal: Works on any website with article content
• 🔒 Privacy First: All data stored locally in your browser
• 💾 Export Ready: Clean markdown files ready to use

Installation

From Source (Developer Mode)

1. Clone or download this repository:

   git clone https://github.com/twoknow/x-article-saver.git

2. Open Chrome and navigate to chrome://extensions/
3. Enable Developer mode (toggle in top-right corner)
4. Click Load unpacked
5. Select the x-article-saver folder
6. The extension icon should appear in your toolbar

Note: This extension is currently available for manual installation. Chrome Web Store listing coming soon!

Usage

Saving Content

1. Navigate to a page you want to save:
   • X.com post/video page (x.com/user/status/...)
   • Any webpage with article content
2. Click the extension icon
3. The popup shows the detected page type (Article, Tweet, Video Post)
4. Click Save Current Page
5. The content will be saved and appear in your list

Managing Saved Items

• Download: Click "Download" to get a markdown file
• Delete: Click "Delete" to remove from saved list

Supported Content Types

X.com / Twitter

• Regular Posts: Short tweets (< 280 chars)
• Long Posts: Extended posts (> 280 chars)
• Video Posts: Posts with embedded videos (includes video metadata)
• Articles: X.com long-form articles

Other Websites

• Articles with title, content, author
• Blog posts
• News articles
• Academic papers

Output Format

# Article Title

**Author:** Author Name (@handle)

## Summary

Brief summary of the content...

## Video (for video posts)

**Video URL:** https://...
**Thumbnail:** https://...
**Duration:** 2:30

> Note: Download videos directly from X.com or use a video downloader tool.

## Keywords

`keyword1`, `keyword2`, `keyword3`

## Content

Main article text...

## References

1. Reference 1
2. Reference 2

---

## Metadata

| Field | Value |
|-------|-------|
| Type | Video Post |
| Source | x.com |
| Date Saved | February 12, 2026 |
| URL | [Link](https://...) |

**Tags:** `video` `x-com`

Project Structure

article-saver/
├── manifest.json           # Extension configuration (Manifest V3)
├── icons/                  # Extension icons
├── background/
│   └── background.js       # Service worker - storage & markdown generation
├── content/
│   └── content.js          # Content extraction for all sites
└── popup/
    ├── popup.html          # Popup UI
    ├── popup.js            # Popup logic
    └── popup.css           # Styling

Troubleshooting

"No post found on this page"

• Make sure you're on a specific X.com post page (x.com/user/status/...)
• Wait for the page to fully load before saving

"Could not extract article content"

• The page may not have standard article structure
• Try refreshing the page and saving again

Content script not loading

• Reload the extension in chrome://extensions/
• Refresh the page you're trying to save

Privacy & Data

• ✅ All data is stored locally in Chrome's local storage
• ✅ No external servers or API calls
• ✅ No tracking or analytics
• ✅ You have full control over your saved articles
• ✅ No personal information is collected

Contributing

Contributions are welcome! Here's how you can help:

1. Report Bugs: Open an issue with details about the problem
2. Suggest Features: Share your ideas for improvements
3. Submit PRs: Fix bugs or add features
4. Improve Documentation: Help make the docs clearer

Development Setup

1. Fork and clone the repository
2. Make your changes
3. Test the extension locally (see Installation above)
4. Submit a pull request

Code Structure

• background/background.js - Service worker for storage and markdown generation
• content/content.js - Content extraction from web pages
• popup/ - Extension popup UI (HTML, CSS, JS)
• manifest.json - Extension configuration (Manifest V3)

License

MIT License - feel free to use this project for personal or commercial purposes.

Acknowledgments

Built with Manifest V3 for modern Chrome extensions. Optimized for Obsidian but works with any markdown editor.

Changelog

v3.0.0 (2026-02-12)

• Unified content script for all sites
• Added video detection for X.com posts
• Removed "academic-style" restriction for articles
• Improved content extraction
• Better UI with page type detection
• Fixed content script conflict issue

v2.1.0 (2026-01-04)

• Rewrote X.com extraction using semantic selectors
• Added proper h2/h3 header detection
• Fixed title truncation issues

v2.0.0 (2026-01-03)

• Complete rebuild from twitter-activity-tracker
• Simplified architecture
• Academic markdown format

Roadmap

• Firefox support
• Batch download multiple articles
• Custom markdown templates
• Tag management system
• Browser sync across devices

Support

If you find this extension useful, please:

• ⭐ Star this repository
• 🐛 Report bugs via Issues
• 💡 Share feature ideas
• 📢 Spread the word

---

Current Version: 3.0.0 | Last Updated: February 12, 2026