跳到內容

note 匯出

mdi build manuscript.mdi --to note 會產生 UTF-8 的 manuscript_note.txt。它是 note 編輯器輸入 profile,不是標準 Markdown,也不是 .note 檔案。--to txt-all 會包含這第六種文字格式。

note 官方將 Markdown 寫法定義為編輯器快捷方式,而不是匯入格式;部分 寫法需要接著輸入空格或 Return。上傳與工具列專用屬性也無法放進純文字。 Ruby 不同:|親文字《讀音》 會在儲存草稿或發布時生效,而且全形、 半形縱線都可以使用。

note 的 Import 畫面只接受 WXR(WordPress XML)與 MT text,不接受這個 檔案。整篇貼上並不是官方保證的 Markdown import;若 shortcut 沒有啟動, 需要重新輸入 trigger 及其後的空格/Return。

MDI / Markdown 輸入note 輸出契約
H1## 標題note 大標題
H2–H6### 標題note 只有大小兩級標題
strong / GFM delete**粗體** / ~~刪除線~~ 尾端半形空格是官方 activation input 的一部分
有序/無序清單1. item / - item保留可讀縮排;真正巢狀需在 note 用 Tab/Shift+Tab
blockquote> 引用引用來源專用欄位無純文字語法
code block保留 source label 的 fenced code只有精確 triple-backtick mermaid 有官方 diagram 契約
thematic break---note 分隔線 shortcut
MDI ruby|親文字《讀音》note 原生 ruby
正文已有的 note TeX$${...}$$ / $$ block保留;note 不允許 inline TeX 的標題/引用會降級成內容
bare URLbare URL可讀來源;embed 需把 URL 單獨貼到空段落,必要時按 Enter
link / imagelabel (URL) / 圖片: alt (URL)可讀降級
footnote內文編號 + 文末注note 沒有 footnote block
tabletab-separated textnote 沒有 table block

縱中橫、傍點、割注、kerning、no-break、page break、task checkbox、 italic、inline code 與 raw HTML 沒有 note 官方對應表示。匯出器保留可讀 內容,只移除不支援的樣式。MDI page break 會替換成視覺 ---,因此不保留 分頁語意。

note 沒有文件化 shortcut 或 ruby delimiter 的 backslash escape。匯出器 不會發明 escape 來污染一般標點;與 note 記法相同的 literal sequence 因此無法在這個純文字 profile 中 lossless 表示。

note 能力文字匯出狀態
段落、換行、兩級標題、粗體、刪除線、清單、引用、code、分隔線輸出 shortcut input sequence;不保證整篇貼上會自動啟動
巢狀清單保留可讀縮排;用 Tab/Shift+Tab 等在 UI 建立真正階層,最多五層
Ruby保留原生記法;套用粗體/連結時選取範圍需涵蓋完整 |親文字《讀音》
inline/display TeX在支援的正文 context 保留;inline 不可用於標題、code、引用,另有 KaTeX/iOS 限制
Mermaid保留 exact triple-backtick mermaid;fence collision 降級成可讀 code
文字連結保留 label 與 URL;把連結套到選取文字仍需 UI
置中/靠右保留內容;對齊需 UI
引用來源與來源 URL保留引用;專用來源欄需 UI
目錄保留標題;插入/啟用目錄需 UI
本文圖片、ALT、圖片說明、尺寸、圖片連結保留 alt 與 URL;上傳與圖片屬性需 UI
封面圖與標題欄不屬於正文;從 front matter 參考後在發布 UI 設定
檔案、原生音訊、comic 上傳純文字無法表示
外部影片、音樂、音訊、SNS、文章、設計、商務、表單、地圖、購物、活動、開發、漫畫/遊戲、群募、招聘、新聞、食譜及其他 embed保留 bare URL;建立 embed 仍取決於空段落單獨貼上/Enter、provider 權限及 notebot 存取
日/美股價 shortcut 與 note Money URL保留 literal;記法只支援 Web、需要 Return、固定六個月;ETF/REIT/基金/指數不支援記法
hashtag、價格、付費試讀線、發布狀態、留言/喜歡等 note 屬性不屬於正文;在 note 發布 UI 設定
note Import/Export--to note 不是 WXR/MT,不能交給 Import;note 自身匯出是 WXR ZIP 加 assets

外部 provider 清單會獨立更新,不應硬編成 MDI grammar;以 note 官方即時 清單為準。

在新 note 文章正文貼上 UTF-8 輸出。這只證明文字保留,不證明 shortcut 已啟動;仍為 literal 的區塊要重新輸入 marker 與空格/Return,巢狀清單 用 Tab/Shift+Tab 設定。embed URL 要單獨貼進空段落並在必要時按 Enter。 儲存草稿後驗證 Ruby;圖片上傳、對齊、圖片說明、引用來源、目錄和發布 metadata 必須在 UI 完成。

官方資料: