Markdown RSS

Read your favorite RSS feeds inside a clean Obsidian side panel — subscribe via a plain Markdown file, filter by keywords, and save articles straight into your vault.

Features

• Markdown as the feed list. All subscriptions live in a plain-text RSS Feeds.md file you can edit by hand, sync with git/Obsidian Sync, and batch-edit like any other note. No hidden database.
• Inline feed control. Disable a feed by appending | 禁用 to its line; remove the marker to re-enable. The file is the single source of truth.
• OPML import. Bring your subscriptions from any other reader, with a checklist of everything found before anything is written.
• Keyword filters. Whitelist (only show) and blacklist (hide) rules as compact pills, with a selectable AND/OR combination mode and a live status line showing which rules are in effect.
• One-click saving. Save any article as a Markdown note with a configurable file-name template.
• Reading position memory. Scroll-up button remembers where you were; the scroll-down button returns you to it — including across refreshes and panel reopens.
• Works on mobile. Pure Obsidian APIs only (no Node/Electron dependencies).

Installation

1. Open Obsidian → Settings → Community plugins → Browse.
2. Search for Markdown RSS (by XMMW) and install it.
3. Click the RSS icon in the ribbon (or run the "Open feed panel" command) to open the panel.

To install a beta version manually, download main.js, manifest.json, and styles.css from the latest release into your vault's .obsidian/plugins/markdown-rss/ folder.

Usage

Adding feeds

Edit RSS Feeds.md in your vault root (path configurable in settings):

## Tech
- https://sspai.com/feed |少数派
- https://www.ruanyifeng.com/blog/atom.xml | 阮一峰的网络日志

A ## heading starts a category; each feed is a line with a URL and an optional | display name. You can also add feeds from the panel's ⋯ menu (Add feed / Batch add / Import OPML). After hand-editing the file, click Refresh to apply.

Disabling a feed

- https://example.com/feed.xml | Example | 禁用

禁用 / 停用 / disabled / off disable the feed; anything else (or no marker) keeps it enabled.

Keyword filters

Under the search box in the panel: green pills are whitelist rules (only show matching articles), red pills are blacklist rules (hide matching articles). Click a pill to pause/resume it, × to delete. Choose AND/OR combination next to the section title. Matching covers the article title and summary only.

Saving articles

Click Save to note on an article card; the note is written to your vault (default folder RSS Articles) using the {date}-{title} template.

Built-in user manual

Settings → Markdown RSS → Settings → User manual opens the full manual inside Obsidian.

Network access

This plugin fetches the feed URLs you subscribe to (via Obsidian's requestUrl API) and opens article links in your browser. It contains no tracking, no remote code execution, and no telemetry. Feed data is stored locally in your vault under .rss-reader/.

License

MIT

---

中文说明

Markdown RSS 把你订阅的源汇总到 Obsidian 侧栏：订阅源清单就是一个纯文本 Markdown 文件（RSS Feeds.md），可手编、可同步；行尾加 | 禁用 即可停用某个源；支持 OPML 导入、关键词白名单/黑名单筛选（药丸式规则、可选「同时满足/任一满足」组合）、文章一键收藏为笔记，并记住你的阅读位置。完整使用手册已内置于插件：设置 → Markdown RSS → 设置 → 使用说明。