OneNote 遷移實(shí)戰(zhàn)終極指南onenote-md-exporter 5 步完成筆記無(wú)損轉(zhuǎn)換【免費(fèi)下載鏈接】onenote-md-exporterConsoleApp to export OneNote notebooks to Markdown formats項(xiàng)目地址: https://gitcode.com/gh_mirrors/on/onenote-md-exporter深夜十一點(diǎn)前端工程師阿哲盯著屏幕發(fā)愁他在 OneNote 里攢了六年的八百多篇技術(shù)筆記眼看就要隨著公司回收 Office 賬號(hào)一起消失。他試過復(fù)制粘貼格式碎成一地也試過在線轉(zhuǎn)換工具結(jié)果第一步就要求把整個(gè)筆記本上傳云端他猶豫了。直到有人向他推薦了 onenote-md-exporter——一款能在本地把 OneNote 筆記本完整導(dǎo)出為 Markdown 的命令行工具這段遷移故事才終于迎來(lái)轉(zhuǎn)機(jī)。如果你也囤著幾年的筆記不敢動(dòng)或者正打算從 OneNote 搬到 Obsidian、Joplin 這類現(xiàn)代筆記軟件這篇實(shí)戰(zhàn)指南就是為你準(zhǔn)備的。我們不談虛的從為什么會(huì)踩坑講到五步完成首次導(dǎo)出再到不同身份的人怎么把工具用到極致一次講透。遷移前 vs 遷移后差的不只是文件格式先別急著操作。動(dòng)工之前我們先回答一個(gè)關(guān)鍵問題為什么不能直接在 OneNote 里導(dǎo)出、再手動(dòng)搬過去答案藏在下面這張對(duì)照表里。同樣是搬筆記用對(duì)工具和用手工搬運(yùn)體驗(yàn)完全是兩回事。對(duì)比維度遷移前困在 OneNote 里遷移后落入 Markdown 生態(tài)排版與格式表格、字體顏色、嵌入文件換個(gè)軟件就亂簡(jiǎn)單表格轉(zhuǎn)成 Markdown復(fù)雜表格保留為 HTML圖片附件原位存放層級(jí)結(jié)構(gòu)筆記本→分區(qū)→頁(yè)面搬出去就塌方成一層分區(qū)與子分區(qū)變成文件夾父頁(yè)面變成子頁(yè)面的文件夾內(nèi)部鏈接OneNote 專屬鏈接在別處全是死鏈自動(dòng)改寫為 Wiki 鏈接或標(biāo)準(zhǔn) Markdown 鏈接數(shù)據(jù)隱私在線工具必須上傳全部筆記全程本地處理筆記不離開你的電腦長(zhǎng)期價(jià)值私有格式隨時(shí)可能被生態(tài)綁架開放的 .md 文本任何編輯器都能打開天然適合備份檢索能力只能在 OneNote 里搜可以被 Obsidian、Joplin 全文索引本地搜索又快又準(zhǔn)一句話總結(jié)手工搬運(yùn)是在搬家而這款工具是在整棟樓平移——樓層關(guān)系、房間里的家具擺設(shè)盡量原樣保留。當(dāng)然盡量?jī)蓚€(gè)字背后藏著不少細(xì)節(jié)。聽起來(lái)很美好先別急著下結(jié)論我們直接從零開始走一遍完整流程你自己感受一下。五步完成首次導(dǎo)出從環(huán)境準(zhǔn)備到看見成果記住一個(gè)原則先跑通再優(yōu)化。第一次別追求完美配置用默認(rèn)參數(shù)導(dǎo)出成功就算邁過了最大的一道坎。第 1 步確認(rèn)環(huán)境達(dá)標(biāo)onenote-md-exporter 是個(gè) Windows 下的控制臺(tái)程序?qū)δ愕碾娔X有三個(gè)基本要求操作系統(tǒng)Windows 10 及以上OneNote2013 或更高版本注意Windows 商店版不支持請(qǐng)用桌面版Word2013 或更高版本前兩項(xiàng)好理解為什么還要 Word后面講原理時(shí)會(huì)解釋——它和 Pandoc 一起是轉(zhuǎn)換鏈路里的關(guān)鍵角色。先記住這三樣缺一不可。 小貼士發(fā)布版本是 .NET 10 的自包含程序解壓即用通常不需要額外安裝運(yùn)行時(shí)。只有從源碼自己編譯時(shí)才需要準(zhǔn)備開發(fā)環(huán)境。第 2 步拿到工具兩種方式任選其一懶人路線直接下載最新發(fā)布的壓縮包解壓到任意目錄折騰路線動(dòng)手克隆源碼自己構(gòu)建# 克隆項(xiàng)目源碼適合想二次開發(fā)或自行編譯的讀者 git clone https://gitcode.com/gh_mirrors/on/onenote-md-exporter無(wú)論哪條路解壓后請(qǐng)留意src/OneNoteMdExporter/pandoc/目錄——里面有一個(gè)pandoc-3.8.3-windows-x86_64.zip壓縮包。把它解開讓pandoc.exe與程序在同一目錄下否則后面的格式轉(zhuǎn)換會(huì)罷工。第 3 步讓 OneNote 做好準(zhǔn)備啟動(dòng) OneNote確認(rèn)你要導(dǎo)出的筆記本已經(jīng)加載、并且同步完成。這一步看起來(lái)無(wú)關(guān)緊要其實(shí)是最常見的翻車點(diǎn)OneNote 的云端同步策略比較佛系有些圖片和附件只存了縮略圖。如果本機(jī)沒有完整內(nèi)容導(dǎo)出結(jié)果就會(huì)缺圖少件。后面避坑部分還會(huì)專門講它。第 4 步跑起來(lái)選筆記本、選格式直接雙擊運(yùn)行OneNoteMdExporter.exe它會(huì)列出檢測(cè)到的所有筆記本你輸入編號(hào)即可選擇。接著它會(huì)問你導(dǎo)出格式輸入 1Markdown 文件夾格式——適合 Obsidian、Logseq 這類通用 Markdown 編輯器輸入 2Joplin 原始目錄格式——專門給 Joplin 用的導(dǎo)入后連筆記層級(jí)都給你建好。選完格式程序會(huì)問你要不要現(xiàn)在改設(shè)置。第一次建議直接回車跳過用默認(rèn)值就好。**然后呢去沖杯咖啡。**? 導(dǎo)出期間程序會(huì)逐頁(yè)處理結(jié)束后會(huì)自動(dòng)用資源管理器打開導(dǎo)出文件夾讓你第一時(shí)間看到成果。第 5 步認(rèn)識(shí)你的導(dǎo)出結(jié)果打開導(dǎo)出文件夾你會(huì)看到這樣的結(jié)構(gòu)我的筆記本/ ├── 分區(qū)A/ │ ├── 父頁(yè)面/ │ │ ├── 子頁(yè)面.md │ ├── 普通頁(yè)面.md │ └── resources/ # 圖片與附件集中存放處 ├── 分區(qū)B/ │ └── ...分區(qū)變成文件夾頁(yè)面變成.md文件圖片和附件集中放在resources目錄Markdown 里用相對(duì)路徑引用它們。整個(gè)目錄拿到任何 Markdown 編輯器里都能直接打開。?? 注意默認(rèn)配置下頁(yè)面在分區(qū)內(nèi)的排序依賴文件名。如果順序?qū)δ悴恢匾梢院雎匀绻茉谝饨ㄗh改用 Joplin 格式它保留原始順序。按需分層定制基礎(chǔ)、進(jìn)階、極致三種玩法跑通只是第一步。想讓導(dǎo)出結(jié)果長(zhǎng)得像你原來(lái)的筆記你得學(xué)會(huì)調(diào)參。所有配置都寫在程序目錄下的appSettings.json文件里點(diǎn)擊查看默認(rèn)配置分三個(gè)層次理解就夠?；A(chǔ)需求三個(gè)參數(shù)解決 80% 的問題絕大多數(shù)個(gè)人用戶改這三個(gè)就夠了{(lán) AddFrontMatterHeader: true, // 每頁(yè)開頭加 YAML 元數(shù)據(jù)標(biāo)題、創(chuàng)建/修改時(shí)間 ProcessingOfPageHierarchy: HierarchyAsFolderTree, // 父頁(yè)面作為子頁(yè)面的文件夾 OneNoteLinksHandling: ConvertToWikilink // 內(nèi)部鏈接轉(zhuǎn)成 [[Wiki鏈接]]Obsidian 雙鏈友好 }想去 Obsidian 玩雙向鏈接把OneNoteLinksHandling設(shè)為ConvertToWikilink想去 Joplin改成ConvertToMarkdown更合適什么都不想要就想把鏈接刪干凈設(shè)為Remove。進(jìn)階需求按場(chǎng)景挑著改{ ResourceFolderLocation: RootFolder, // 所有圖片附件集中放在根目錄 resources 文件夾 PanDocMarkdownFormat: gfm, // 用 GitHub 風(fēng)格 Markdown 語(yǔ)法 UseHtmlStyling: true, // 允許用 HTML 保留字體顏色、背景色等樣式 IndentingStyle: ConvertToBullets // OneNote 縮進(jìn)轉(zhuǎn)成列表觀感最接近原筆記 }ResourceFolderLocation有兩個(gè)值RootFolder集中存放和PageParentFolder每個(gè)頁(yè)面旁邊各放一份資源。圖片多的筆記本用前者省心想每個(gè)頁(yè)面自成一體、方便單獨(dú)分享時(shí)用后者。UseHtmlStyling尤其值得注意如果你用的編輯器支持 HTMLObsidian、Joplin 都支持務(wù)必開著它能幫你保住字體顏色、背景色這些 Markdown 表達(dá)不了的東西。極致需求為大型筆記本兜底{ PageTitleMaxLength: 50, // 頁(yè)面標(biāo)題超長(zhǎng)時(shí)自動(dòng)截?cái)啾苊馕募^長(zhǎng) MdMaxFileLength: 50, // 限制文件與文件夾名長(zhǎng)度防止路徑超長(zhǎng)報(bào)錯(cuò) PostProcessingRemoveQuotationBlocks: true, // 去掉 Pandoc 偶發(fā)產(chǎn)生的多余引用塊 MaxTwoLineBreaksInARow: true // 最多允許連續(xù)兩個(gè)換行版面更干凈 }這四個(gè)是保險(xiǎn)絲級(jí)別的參數(shù)平時(shí)不用動(dòng)等你遇到路徑過長(zhǎng)、空行過多這類問題再回來(lái)翻它們。參數(shù)再好最終還是要落到具體的人身上。下面這三個(gè)真實(shí)場(chǎng)景或許你能在某個(gè)故事里看到自己的影子。三個(gè)人的遷移故事他們是這樣用的故事一知識(shí)管理愛好者小鹿把 1200 篇筆記搬進(jìn) Obsidian小鹿是位產(chǎn)品經(jīng)理Obsidian 用了兩年卻始終有一塊心病主力筆記還在 OneNote 里兩邊割裂檢索全靠回憶。她給自己定了個(gè)三步走計(jì)劃。第一步先用一個(gè)測(cè)試筆記本跑通流程確認(rèn)ProcessingOfPageHierarchy HierarchyAsFolderTree下層級(jí)沒塌第二步把OneNoteLinksHandling調(diào)成ConvertToWikilink讓舊筆記里的互鏈變成 Obsidian 的雙鏈第三步開著AddFrontMatterHeader讓每篇筆記自帶時(shí)間戳。第一次導(dǎo)出完我打開 Obsidian 的圖譜視圖看到幾千個(gè)節(jié)點(diǎn)連成一片當(dāng)時(shí)就愣住了。小鹿說(shuō)那一刻才真正感覺我的知識(shí)資產(chǎn)是自己的了。故事二咨詢公司 IT 負(fù)責(zé)人老周三天搞定團(tuán)隊(duì)文檔遷移老周所在的團(tuán)隊(duì)有二十多人筆記散落在項(xiàng)目文檔會(huì)議記錄客戶資料等好幾個(gè)筆記本里要統(tǒng)一遷到團(tuán)隊(duì)知識(shí)庫(kù)。他的思路是先集中、再分發(fā)把ResourceFolderLocation設(shè)為RootFolder所有圖片集中管理然后用一個(gè)批處理腳本逐個(gè)筆記本導(dǎo)出全程無(wú)人值守REM 批量導(dǎo)出多個(gè)筆記本配合 --no-input 跳過交互--ignore-errors 讓單個(gè)失敗不中斷 for %%i in (項(xiàng)目文檔 會(huì)議記錄 客戶資料) do ( OneNoteMdExporter.exe --notebook %%i --format 1 --no-input --ignore-errors )腳本跑完那晚我基本沒管它第二天早上來(lái)三個(gè)筆記本整整齊齊躺在共享盤里。老周的經(jīng)驗(yàn)是遷移團(tuán)隊(duì)知識(shí)庫(kù)最怕的不是慢而是中斷后沒人盯著。故事三自動(dòng)化愛好者大劉把導(dǎo)出變成下班自動(dòng)執(zhí)行大劉是運(yùn)維出身他不想每次手動(dòng)點(diǎn)。他研究了命令行參數(shù)后發(fā)現(xiàn)工具支持--notebook、--format、--section、--page等參數(shù)甚至能精確到只導(dǎo)出某個(gè)分區(qū)的某一頁(yè)。他把自己的學(xué)習(xí)筆記筆記本做成一個(gè)計(jì)劃任務(wù)每周五 18:00 自動(dòng)執(zhí)行一次全量導(dǎo)出作為備份# 全自動(dòng)備份導(dǎo)出全部筆記本無(wú)需任何交互輸入 OneNoteMdExporter.exe --all-notebooks --format 1 --no-input數(shù)據(jù)安全這事兒靠自覺靠不住靠定時(shí)任務(wù)才靠得住。大劉的這句話值得每個(gè)筆記重度用戶記下來(lái)。三個(gè)故事都很順利別高興太早。真實(shí)世界里總有幾個(gè)坑在前面等著你。高頻問題自查清單遇到報(bào)錯(cuò)先看這里Q1一啟動(dòng)就報(bào)System.Runtime.InteropServices.COMException這是最常見的報(bào)錯(cuò)多半不是你操作的問題而是本機(jī) Office/OneNote 組件狀態(tài)異常。按順序排查重啟 OneNote 和 Word再運(yùn)行一次程序確認(rèn)你用的是 OneNote 桌面版而不是 Windows 商店版如果還不行按這篇文檔把筆記本導(dǎo)出成.onepkg包換一臺(tái)干凈的機(jī)器導(dǎo)入后再導(dǎo)出。Q2導(dǎo)出后圖片顯示不出來(lái) / 變成空白十有八九是 OneNote 本地沒有完整的圖片文件。解決辦法打開 OneNote文件 → 選項(xiàng) → 同步勾選下載所有文件和圖像強(qiáng)制同步一次筆記本重新導(dǎo)出。這條建議來(lái)自官方 FAQ屬于命中率最高的修復(fù)方案。Q3大型筆記本導(dǎo)出又慢又卡大庫(kù)的處理時(shí)間主要花在逐頁(yè)轉(zhuǎn)格式上?？梢赃@樣拆解先只導(dǎo)一個(gè)分區(qū)試試水用--section參數(shù)控制范圍確認(rèn)流程無(wú)誤再全量導(dǎo)出給程序留足磁盤空間和內(nèi)存導(dǎo)出目錄別放在快滿的盤上導(dǎo)出期間別在 OneNote 里繼續(xù)編輯筆記避免文件占用沖突。Q4有些內(nèi)容消失了先對(duì)照這張能力邊界表看消失的是不是本就支持的內(nèi)容內(nèi)容類型導(dǎo)出結(jié)果文本、簡(jiǎn)單表格? 完整保留復(fù)雜表格、字體/背景色? 以 HTML 形式保留圖片、附件? 原樣保存文本標(biāo)簽待辦、星標(biāo)等? 轉(zhuǎn)為表情符號(hào)繪圖內(nèi)容 拍平成圖片密碼保護(hù)的分區(qū) 需先在 OneNote 里解鎖手寫筆跡 無(wú)法轉(zhuǎn)換遷移前記得先解鎖所有受密碼保護(hù)的分區(qū)——這是最容易被忽略的一條。搞清楚了邊界我們?cè)偻钔谝粚舆@套無(wú)損轉(zhuǎn)換到底是怎么實(shí)現(xiàn)的背后的原理一位翻譯官和一位校對(duì)編輯把 onenote-md-exporter 想象成一個(gè)三人翻譯團(tuán)隊(duì)你就能理解它的工作方式讀原文它通過 OneNote 的 COM 接口把每個(gè)頁(yè)面的內(nèi)容本質(zhì)是 XML 結(jié)構(gòu)讀取出來(lái)做一輪預(yù)處理——把折疊段落展開、記錄字體顏色等細(xì)節(jié)打草稿把頁(yè)面內(nèi)容先轉(zhuǎn)成臨時(shí)的 DocX 文檔——這就是為什么需要安裝 Word正式翻譯調(diào)用 Pandoc——那位通用格式翻譯官把 DocX 轉(zhuǎn)成 Markdown校對(duì)編輯用一系列正則規(guī)則做后處理修復(fù)格式轉(zhuǎn)換產(chǎn)生的錯(cuò)別字比如去掉多余的引用塊、合并連續(xù)空行。OneNote 頁(yè)面 XML → 臨時(shí) DocX → Pandoc 轉(zhuǎn) Markdown → 正則后處理 → 最終 .md 資源文件夾整個(gè)過程完全在本地進(jìn)行不依賴微軟云這也是它敢承諾數(shù)據(jù)安全的底氣所在。 順帶一提整套翻譯流程是讀原文再轉(zhuǎn)述所以 OneNote 里的層級(jí)結(jié)構(gòu)、頁(yè)面順序這類骨架信息理論上可以做到近乎無(wú)損地搬進(jìn) Markdown 生態(tài)。核心轉(zhuǎn)換邏輯在 src/OneNoteMdExporter/Services/Export/ 目錄下感興趣的讀者可以去翻翻源碼。理解了原理接下來(lái)就是把工具用到極致的時(shí)候了。效率進(jìn)階從能用到好用的四個(gè)技巧技巧一按需導(dǎo)出別每次都全量跑只想找一篇舊筆記用--section限定分區(qū)用--page精確到頁(yè)面幾秒鐘就出結(jié)果不必為整本筆記本付等待時(shí)間。技巧二給 Joplin 用戶一條捷徑如果你最終要去的是 Joplin直接選格式 2Joplin 原始目錄然后打開 Joplin文件 → 導(dǎo)入 → RAW - Joplin Export Directory選中導(dǎo)出文件夾即可。相比先導(dǎo) ENEX 再導(dǎo) Joplin 的繞路方案這個(gè)流程能保住分區(qū)層級(jí)和頁(yè)面順序細(xì)節(jié)對(duì)比見官方遷移文檔。技巧三用測(cè)試筆記本降低試錯(cuò)成本倉(cāng)庫(kù)里附帶了一個(gè)樣例筆記本 sample/TestNotebook.onepkg。正式遷移前先用它或自己建的小筆記本跑一遍各種配置組合確認(rèn)效果再上真庫(kù)風(fēng)險(xiǎn)最小。技巧四導(dǎo)出后的質(zhì)量檢查清單每次導(dǎo)出完成花五分鐘抽查三件事結(jié)構(gòu)對(duì)不對(duì)文件夾層級(jí)和原筆記本的分區(qū)、子分區(qū)是否一一對(duì)應(yīng)內(nèi)容全不全隨機(jī)抽 10% 的頁(yè)面重點(diǎn)看表格、圖片、代碼塊鏈接靈不靈點(diǎn)開幾處內(nèi)部鏈接確認(rèn) Wiki 鏈接能跳轉(zhuǎn)到目標(biāo)頁(yè)面。順便說(shuō)一句如果你用下來(lái)覺得不錯(cuò)這個(gè)項(xiàng)目歡迎任何形式的參與——界面支持多語(yǔ)言翻譯文件放在 src/OneNoteMdExporter/Resources/ 目錄想提交新功能或?qū)С龈袷娇梢詤⒄?doc/contribute.md 里的約定把測(cè)試樣例一起附上即可。現(xiàn)在輪到你了回顧整篇文章其實(shí)就一句話onenote-md-exporter 幫你把 OneNote 遷移這件事從高風(fēng)險(xiǎn)、高成本的手工活變成了可重復(fù)、可驗(yàn)證的腳本活。你的筆記不會(huì)再被單一生態(tài)鎖死你的知識(shí)資產(chǎn)從此有了開放的格式作為退路。別等有空再說(shuō)了。按下面這份行動(dòng)清單現(xiàn)在就動(dòng)手檢查電腦上的 OneNote 和 Word 版本確認(rèn)是桌面版且不低于 2013下載或克隆工具解壓 pandoc 壓縮包到程序目錄用一個(gè)小型測(cè)試筆記本跑通首次導(dǎo)出驗(yàn)證 Markdown 文件夾結(jié)構(gòu)按你的目標(biāo)平臺(tái)Obsidian 選 Wiki 鏈接、Joplin 選 Markdown 鏈接調(diào)整appSettings.json全量導(dǎo)出前記得先解鎖所有密碼保護(hù)的分區(qū)、確保圖片已完整下載導(dǎo)出完成后抽查質(zhì)量然后——把備份腳本加入你的定期任務(wù)清單。知識(shí)遷移是場(chǎng)馬拉松但最艱難的一步永遠(yuǎn)是開始。工具已經(jīng)就位剩下的交給你了。【免費(fèi)下載鏈接】onenote-md-exporterConsoleApp to export OneNote notebooks to Markdown formats項(xiàng)目地址: https://gitcode.com/gh_mirrors/on/onenote-md-exporter創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考