Skip to content
ncepuee edited this page Aug 31, 2026 · 1 revision

Usage

Sync the current note

Open any Markdown note and use one of:

  • Command palette → Sync current note to CSDN draft
  • Ribbon icon (CSDN logo) → Sync current note to CSDN draft

The plugin fills the CSDN Markdown editor with your note and saves it as a draft. It only ever looks for the save-draft button — it never touches publish.

Frontmatter reference

Read from the YAML frontmatter at the top of your note:

---
title: My article title        # used as the CSDN title
description: One-sentence summary   # or use `summary`
tags:
  - Python
  - Obsidian
cover: https://example.com/cover.png   # or use `image`
---
Field Purpose
title CSDN article title; falls back to the note filename
description / summary Article summary shown under the title
tags List of CSDN tags
cover / image Cover image URL

Local image references in the note are detected and reported, but images are not uploaded automatically — host them (or CSDN's image service) yourself.

Draft manager

Ribbon icon → Open CSDN draft box, or the command palette command Open CSDN draft box.

  • Browse the drafts of the currently active account as cards
  • Search by title, refresh, paginate
  • Open a draft in the CSDN editor on csdn.net to edit it there (write-back workflow: local edits go out, but you can also continue in the browser)
  • Delete a draft — always asks for confirmation, and the deletion happens through CSDN's own content management page

Multi-account

In Settings → CSDN accounts:

  • Add account — give it any display name
  • Each account gets an isolated Chromium profile, so parallel logins never clash
  • Login opens a browser window for that account; log in manually once
  • Switch the active account from the dropdown; sync and draft manager operate on the active account
  • Clear login state wipes that account's cookies/profile only

Profiles live under %LOCALAPPDATA%\CSDN-Draft-Publisher\:

playwright-profile      # default account
profiles\account-*      # additional accounts

Open the current note in CSDN

Ribbon icon → Open Current Note in CSDN Editor — handy after syncing, when you want to touch up formatting on the CSDN side.

Settings reference

Setting Default What it does
Bridge URL http://127.0.0.1:8765 Where the local bridge listens. The port part decides the spawn port
Enable bridge service off Starts the Python bridge with the configured interpreter. Turning it off only stops a bridge the plugin itself started — an external one is left alone
Python command python Interpreter used to launch the bridge. Full path to a conda env works
CSDN accounts one default Add / rename / log in / clear login state per account

Good to know

  • If port 8765 is already serving a bridge, the plugin reuses it and will not stop it when you toggle the switch off.
  • The note is saved as a draft on CSDN — nothing is ever published automatically.
  • Syncing requires internet access to csdn.net; everything else stays local.

Clone this wiki locally