XHS Importer Pro

English | 中文

把小红书笔记导入 Obsidian：正文、话题标签、图片与点赞、收藏、评论、转发数据全部存成本地 Markdown，frontmatter 可自由配置，无需登录。

Import Xiaohongshu (小红书) notes into your Obsidian vault as local Markdown — including the full body text, all images, hashtags, author info, and engagement metrics.

---

Features

Placeholders

Use these in any frontmatter field value:

Example frontmatter setup:

---
type: raw
aliases:
创建日期: {{date}}
发布日期: {{publishDate}}
博主: {{author}}
笔记链接: {{source}}
点赞: {{likedCount}}
收藏: {{collectedCount}}
评论: {{commentCount}}
转发: {{shareCount}}
tags:
  - type/excerpt
  - status/to-process
---

A fresh install ships only four fields — aliases, created: {{date}}, tags and 上级概念. Nothing else is written unless you add it yourself: no type, no engagement counts, no author data. The block above is one example configuration, not the default.

The keys shown are Chinese, but the names are entirely yours to change. Obsidian lets you name a property anything you like — the English equivalents (created / published / author / source / likes / saves / comments / shares) work exactly the same way. Two keys must stay as they are: aliases and tags, because they are Obsidian's built-in properties and the alias / tag systems key on those exact names. (type is only English by convention here — it is what the sample vault's Bases filters match on.)

Placeholder names must stay ASCII. They are resolved by /\{\{(\w+)\}\}/, and JavaScript's \w does not cover CJK characters — a Chinese placeholder would silently stay in the note as literal {{...}}. For readability, the settings tab lists every placeholder with a short description instead.

Keep the engagement counts as separate numeric fields rather than one merged string. Merged text cannot be sorted or aggregated by Bases/Dataview, and "which note is the outlier" is the first question you ask when mining a competitor note.

---

Network usage

Required disclosure. This plugin makes network requests, and only in the following situations:

What this plugin does NOT do:

• No analytics, no telemetry, no crash reporting.
• No server component — there is no backend operated by the author.
• No login required. The plugin never asks for, reads, or stores your Xiaohongshu account credentials or cookies.
• No data is sent anywhere other than www.xiaohongshu.com and its image CDN.

Everything is processed locally on your machine. Imported notes are plain Markdown files in your own vault.

---

Installation

From the community plugins directory

1. Open Settings → Community plugins → Browse.
2. Search for XHS Importer Pro and select Install.
3. Select Enable.

Manual install

1. Download main.js, manifest.json and styles.css from the latest release.
2. Create a folder named xhs-importer-pro inside <your-vault>/.obsidian/plugins/.
3. Copy the three files into that folder.
4. Reload Obsidian and enable XHS Importer Pro in Settings → Community plugins.

Via BRAT

Add the repository URL to BRAT to receive beta updates automatically.

---

Usage

1. Copy a Xiaohongshu share link (App: Share → Copy link, or the web share button).
2. In Obsidian, click the ribbon icon or run the command Import Xiaohongshu note.
3. Paste the share text or URL.
4. Choose whether to download images for this import.
5. The note is created in your configured folder with frontmatter, body text and images.

Note: Use share links (xsec_source=app_share / pc_share). Links copied from your browser's address bar carry a session-bound token and will be rejected.

---

Scope & limitations

• Only public single notes are supported. This plugin does not scrape a creator's full profile, search results, or your own bookmarks/likes.
• No author handle / bio / follower count. Those three are only served by the author-profile endpoint, which rate-limits aggressively (repeated requests get redirected to the login page), so most notes failed to return them during batch imports — removed in 1.0.12 (together with the {{authorRedId}}, {{authorDesc}}, {{authorFans}} and {{authorIpLocation}} placeholders). To see the handle, open the profile via {{authorUrl}}.
• Comments cannot be imported. Xiaohongshu serves comment content through a separate endpoint that requires an authenticated session, which this plugin deliberately does not use.
• Video notes keep a remote URL only; the video file itself is not downloaded.
• Parsing depends on Xiaohongshu's current page structure. If the site changes its frontend, field extraction may need updating.

---

Credits

This project is built on the work of others, and is released under the same MIT license:

• Xiaohongshu Importer Plus by lxl448080113 — the direct upstream this plugin derives from.
• xiaohongshu-importer by bnchiang96 — the original plugin that upstream was adapted from.

Both copyright notices are preserved in the LICENSE.

---

License

MIT