youdaonote list

• command not found

  → Immediately jump to "CLI Not Installed Handling" for automatic installation. Do NOT only display installation steps and let users operate manually
• API Key error → Prompt users to visit https://mopen.163.com to obtain an API Key (must log in with a mobile phone number, and the cloud note account must be bound to a mobile phone number), then execute

  youdaonote config set apiKey <User-provided Key>

  . This is the only address for obtaining the API Key; do NOT inform users of other addresses.
• Directory list returned normally → Run

  youdaonote version

  to check the version. If the version is lower than

  minCliVersion

  , upgrade is required: if the CLI supports the

  upgrade

  command, execute

  youdaonote upgrade

  ; otherwise, follow the upgrade method in "CLI Not Installed Handling". For Windows users or if upgrade fails, refer to the installation guide (https://note.youdao.com/help-center/cli-install-guide.html). After the version meets the requirements, run

  youdaonote help --json

  to get a structured description (JSON) of all current CLI capabilities, which is used to confirm whether the command is available. The quick reference table below serves as a fallback

#

**bold**

`

- 

> 

[link](url)

![image](url)

Detected Markdown formatting in content, please select the save method:

A (Recommended) Save as Markdown note (.md)
  → Format is fully preserved, can be displayed and edited normally in the editor

B  Save as Youdao proprietary format (.note)
  → Supports all features of Youdao Cloud Note rich text editor

Please reply with A or B:

contentFile

• Option A:

  save

  command,

  type: "md"

  , add

  .md

  suffix to the file name

  # Step 1: Write tool writes Markdown to /tmp/note-content.md (no JSON escaping needed)
  {"title":"Title.md","type":"md","contentFile":"/tmp/note-content.md","parentId":"Folder ID"}

  Alternative (short content):

  {"title":"Title.md","type":"md","content":"Markdown Content","parentId":"Folder ID"}

• Option B:

  save

  command,

  type: "note"

  ,

  contentFormat: "md"

  , add

  .note

  suffix to the file name

  # Step 1: Write tool writes Markdown to /tmp/note-content.md (no JSON escaping needed)
  {"title":"Title.note","type":"note","contentFormat":"md","contentFile":"/tmp/note-content.md","parentId":"Folder ID"}

  Alternative (short content):

  {"title":"Title.note","type":"note","contentFormat":"md","content":"Markdown Content","parentId":"Folder ID"}

parentId

is an optional field: Fill in the folder ID returned by

youdaonote list

to specify the target directory; if not filled, it will be stored in "My Resources/Favorite Notes" by default.

• User does not explicitly select (replies "whatever"/"you decide", etc.): Default to Option A

• All commands support

  --json

  output for machine-readable format
• Pass large content via

  --file

  to avoid command line parameter limits
• URLs containing

  &

  in Windows CMD must be enclosed in double quotes
• Chinese characters may be garbled in Windows pipe/redirection scenarios (CLI outputs UTF-8, but PowerShell/CMD defaults to GBK interpretation): Execute

  [Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)

  in PowerShell, or

  chcp 65001

  in CMD; run

  youdaonote check

  to view diagnostic suggestions

• id

  output by

  list

  is equivalent to

  fileId

  for

  read

• rawFormat

  returned by

  read

  identifies the original note format:

  md

  =Markdown,

  note

  =Cloud Note,

  txt

  =Plain Text;

  isRaw

  identifies whether the returned content is original (

  true

  =original text can be edited directly,

  false

  =converted plain text)
• Do NOT use

  create

  to save Markdown content:

  create

  does not support

  contentFormat

  , even if the content contains Markdown syntax, it will be saved as plain text with formatting silently lost. For formatting needs, always use

  save

  and specify

  contentFormat: "md"

• The

  save

  command specifies the target folder via the

  parentId

  field in JSON (value comes from the folder ID returned by

  list

  ); if not passed, it will be saved to "My Resources/Favorite Notes" by default. Do NOT use other names such as

  folderId

  — the server will silently ignore unknown fields.