 Obsidian，我只用了一條命令)
把攢了多年的 OneNote 筆記搬進(jìn) Obsidian我只用了一條命令【免費(fèi)下載鏈接】onenote-md-exporterConsoleApp to export OneNote notebooks to Markdown formats項(xiàng)目地址: https://gitcode.com/gh_mirrors/on/onenote-md-exporter小宇的電腦里躺著一個(gè)時(shí)間膠囊整整五年的 OneNote 筆記本兩千多篇筆記從學(xué)生時(shí)代的課件到工作后的技術(shù)總結(jié)。去年他想把這些筆記遷到 Obsidian 時(shí)試過復(fù)制粘貼、試過 OneNote 自帶的導(dǎo)出結(jié)果表格全部散架、圖片路徑全亂、層級(jí)變成一攤平鋪的文件。直到有人向他推薦了onenote-md-exporter——一個(gè)在本地運(yùn)行的命令行工具能把 OneNote 筆記本完整導(dǎo)出為 Markdown 格式適配 Obsidian、Joplin 等主流筆記軟件。這篇記錄就是他的完整遷移手記。它憑什么敢說導(dǎo)出后幾乎不用改小宇最初也是半信半疑直到他搞懂了工具的三個(gè)關(guān)鍵設(shè)計(jì)才明白為什么這次不一樣。第一數(shù)據(jù)從頭到尾不出你的電腦。它直接調(diào)用本機(jī)的 OneNote 和 Word 程序官方 COM 接口讀取原始內(nèi)容整個(gè)過程不依賴任何云端服務(wù)。那些把筆記上傳到網(wǎng)頁再下載的在線轉(zhuǎn)換工具對(duì)存著客戶資料和私人日記的人來說光想想就脊背發(fā)涼。第二筆記本的骨架被完整保留。分區(qū)變成文件夾分區(qū)組變成嵌套目錄子頁面默認(rèn)作為父頁面的下級(jí)文件夾。導(dǎo)出的目錄樹和你在 OneNote 里看到的結(jié)構(gòu)幾乎一一對(duì)應(yīng)而不是把所有頁面嘩啦一下倒進(jìn)同一個(gè)文件夾。第三它天生就是為 Obsidian、Joplin 這類 Markdown 編輯器設(shè)計(jì)的。內(nèi)部鏈接可以轉(zhuǎn)成[[雙鏈]]格式每篇筆記能自動(dòng)加上帶創(chuàng)建時(shí)間、更新時(shí)間的 Front Matter 頭還內(nèi)置了 Pandoc 轉(zhuǎn)換引擎來兜底復(fù)雜表格和格式。這幾點(diǎn)組合起來就形成了下面這個(gè)對(duì)比遷移方式層級(jí)結(jié)構(gòu)內(nèi)部鏈接圖片附件是否安全手工復(fù)制粘貼丟失失效丟失安全OneNote 自帶導(dǎo)出扁平化失效可用安全在線轉(zhuǎn)換網(wǎng)站扁平化失效看運(yùn)氣需上傳云端onenote-md-exporter完整保留轉(zhuǎn)為雙鏈完整保留全程本地從下載到第一份 Markdown照做就行動(dòng)手之前先確認(rèn)三件事Windows 10 及以上、OneNote 2013 及以上注意不支持微軟商店版、Word 2013 及以上。都齊了就跟著走。第一步拿到工具。在命令行里克隆倉庫git clone https://gitcode.com/gh_mirrors/on/onenote-md-exporter第二步補(bǔ)上轉(zhuǎn)換引擎。進(jìn)入src/OneNoteMdExporter/pandoc/目錄把里面的pandoc-3.8.3-windows-x86_64.zip解壓讓pandoc.exe和壓縮包待在同一個(gè)文件夾。沒有這一步程序會(huì)找不到格式轉(zhuǎn)換器。第三步讓 OneNote 就位。啟動(dòng) OneNote確認(rèn)要導(dǎo)出的筆記本已經(jīng)加載并完成同步。程序是讀實(shí)時(shí)狀態(tài)的筆記本沒打開可不行。第四步開始導(dǎo)出。最簡(jiǎn)單的方式是直接雙擊運(yùn)行OneNoteMdExporter.exe它會(huì)列出本機(jī)所有筆記本讓你勾選要導(dǎo)出的對(duì)象、選擇格式還能現(xiàn)場(chǎng)調(diào)整高級(jí)設(shè)置。等它跑完會(huì)自動(dòng)彈出導(dǎo)出文件夾。想要批量或無人值守就用命令行一次指定筆記本和格式OneNoteMdExporter.exe --notebook 我的筆記本 --format 1 --no-input這里的--format 1是 Markdown 文件夾格式--format 2是 Joplin 原始目錄格式--no-input表示全自動(dòng)、不需要任何交互。導(dǎo)出完成后你會(huì)得到類似這樣的目錄結(jié)構(gòu)我的筆記本/ ├─ 工作項(xiàng)目/ │ ├─ 需求文檔/ │ │ ├─ 需求評(píng)審.md │ │ └─ 技術(shù)方案.md │ └─ 周報(bào).md ├─ 生活隨筆.md └─ resources/ ├─ 截圖1.png └─ 附件.pdf頁面是.md文件圖片和附件統(tǒng)一收在resources文件夾里Markdown 內(nèi)部用相對(duì)路徑引用——放進(jìn) Obsidian 倉庫就能直接用不需要再改任何路徑。第一次運(yùn)行這些坑我先替你踩了小宇第一次跑就報(bào)了System.Runtime.InteropServices.COMException差點(diǎn)放棄。后來才知道這是程序沒能和 OneNote 組件握手常見原因就是本機(jī) Office 安裝有問題。這時(shí)候最省事的解法不是重裝 Office而是按doc/notebook-onepkg-export.md里的說明把筆記本導(dǎo)出成.onepkg包換一臺(tái)干凈的電腦導(dǎo)入后再導(dǎo)出 Markdown。效果一樣風(fēng)險(xiǎn)更低。還有幾個(gè)坑提前知道能省下不少時(shí)間導(dǎo)出后圖片是壞的多半是 OneNote 本地根本沒緩存圖片。到「文件 → 選項(xiàng) → 同步」里勾上下載所有文件和圖像強(qiáng)制同步一次再重新導(dǎo)出基本就能解決。密碼保護(hù)的分區(qū)變空了記得在導(dǎo)出前手動(dòng)解鎖鎖著的分區(qū)內(nèi)容不會(huì)進(jìn)入結(jié)果。手寫筆跡直接消失這是工具明確的邊界手寫內(nèi)容不支持轉(zhuǎn)換導(dǎo)出前心里要有數(shù)。文件名太長(zhǎng)導(dǎo)致路徑超限筆記本里有標(biāo)題超長(zhǎng)的頁面時(shí)可以在配置里把MdMaxFileLength調(diào)小一點(diǎn)從源頭避免 Windows 路徑過長(zhǎng)的報(bào)錯(cuò)。小宇跑順之后還總結(jié)出幾個(gè)進(jìn)階技巧你可以按需取用給 Obsidian 用的推薦組合把a(bǔ)ppSettings.json里的OneNoteLinksHandling設(shè)為ConvertToWikilinkOneNote 內(nèi)部鏈接變成[[雙鏈]]雙向鏈接直接可用ProcessingOfPageHierarchy保持HierarchyAsFolderTree層級(jí)就是文件夾AddFrontMatterHeader設(shè)為true每篇筆記自動(dòng)帶上創(chuàng)建/更新時(shí)間方便檢索。給 Joplin 用的推薦組合格式選 2鏈接策略換成ConvertToMarkdown導(dǎo)出后直接以原始目錄方式導(dǎo)入 Joplin標(biāo)簽和層級(jí)都能對(duì)上。一次性導(dǎo)出所有筆記本加個(gè)--all-notebooks參數(shù)它會(huì)忽略--notebook把所有筆記本挨個(gè)處理一遍OneNoteMdExporter.exe --all-notebooks --format 1 --no-input至于它為什么轉(zhuǎn)換得這么穩(wěn)小宇后來大致弄明白了程序先通過 OneNote COM 接口把每頁內(nèi)容導(dǎo)出成 DocX再用 Pandoc 把 DocX 翻譯成 Markdown最后跑一輪正則后處理修復(fù)格式毛刺。這種雙引擎 后處理的思路比他見過的任何單步轉(zhuǎn)換都穩(wěn)妥。出發(fā)前收好這份行動(dòng)清單如果你也動(dòng)了遷移的心思不妨按這個(gè)順序來克隆倉庫按上文把pandoc.exe解壓就位先拿一個(gè)最常用的小筆記本試跑全程開著 OneNote 等它同步完成對(duì)照appSettings.json里的配置項(xiàng)按你要去的平臺(tái)Obsidian 還是 Joplin調(diào)好鏈接策略導(dǎo)出完成后隨機(jī)抽查十幾篇帶表格、圖片的筆記確認(rèn)質(zhì)量遇到報(bào)錯(cuò)先看同目錄下的logs.txt再帶著日志去項(xiàng)目里提問或參與改進(jìn)。知識(shí)遷移從來不是一夜之間的事但好消息是最痛苦的那一步onenote-md-exporter 已經(jīng)幫你走完了。剩下的就是打開 Obsidian和那些老筆記好好重逢。想深入了解 Joplin 遷移細(xì)節(jié)可以翻翻doc/migration-to-joplin.md想?yún)⑴c翻譯或貢獻(xiàn)代碼doc/contribute.md里有完整的指南?！久赓M(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），僅供參考 把攢了多年的 OneNote 筆記搬進(jìn) Obsidian，我只用了一條命令
把攢了多年的 OneNote 筆記搬進(jìn) Obsidian我只用了一條命令【免費(fèi)下載鏈接】onenote-md-exporterConsoleApp to export OneNote notebooks to Markdown formats項(xiàng)目地址: https://gitcode.com/gh_mirrors/on/onenote-md-exporter小宇的電腦里躺著一個(gè)時(shí)間膠囊整整五年的 OneNote 筆記本兩千多篇筆記從學(xué)生時(shí)代的課件到工作后的技術(shù)總結(jié)。去年他想把這些筆記遷到 Obsidian 時(shí)試過復(fù)制粘貼、試過 OneNote 自帶的導(dǎo)出結(jié)果表格全部散架、圖片路徑全亂、層級(jí)變成一攤平鋪的文件。直到有人向他推薦了onenote-md-exporter——一個(gè)在本地運(yùn)行的命令行工具能把 OneNote 筆記本完整導(dǎo)出為 Markdown 格式適配 Obsidian、Joplin 等主流筆記軟件。這篇記錄就是他的完整遷移手記。它憑什么敢說導(dǎo)出后幾乎不用改小宇最初也是半信半疑直到他搞懂了工具的三個(gè)關(guān)鍵設(shè)計(jì)才明白為什么這次不一樣。第一數(shù)據(jù)從頭到尾不出你的電腦。它直接調(diào)用本機(jī)的 OneNote 和 Word 程序官方 COM 接口讀取原始內(nèi)容整個(gè)過程不依賴任何云端服務(wù)。那些把筆記上傳到網(wǎng)頁再下載的在線轉(zhuǎn)換工具對(duì)存著客戶資料和私人日記的人來說光想想就脊背發(fā)涼。第二筆記本的骨架被完整保留。分區(qū)變成文件夾分區(qū)組變成嵌套目錄子頁面默認(rèn)作為父頁面的下級(jí)文件夾。導(dǎo)出的目錄樹和你在 OneNote 里看到的結(jié)構(gòu)幾乎一一對(duì)應(yīng)而不是把所有頁面嘩啦一下倒進(jìn)同一個(gè)文件夾。第三它天生就是為 Obsidian、Joplin 這類 Markdown 編輯器設(shè)計(jì)的。內(nèi)部鏈接可以轉(zhuǎn)成[[雙鏈]]格式每篇筆記能自動(dòng)加上帶創(chuàng)建時(shí)間、更新時(shí)間的 Front Matter 頭還內(nèi)置了 Pandoc 轉(zhuǎn)換引擎來兜底復(fù)雜表格和格式。這幾點(diǎn)組合起來就形成了下面這個(gè)對(duì)比遷移方式層級(jí)結(jié)構(gòu)內(nèi)部鏈接圖片附件是否安全手工復(fù)制粘貼丟失失效丟失安全OneNote 自帶導(dǎo)出扁平化失效可用安全在線轉(zhuǎn)換網(wǎng)站扁平化失效看運(yùn)氣需上傳云端onenote-md-exporter完整保留轉(zhuǎn)為雙鏈完整保留全程本地從下載到第一份 Markdown照做就行動(dòng)手之前先確認(rèn)三件事Windows 10 及以上、OneNote 2013 及以上注意不支持微軟商店版、Word 2013 及以上。都齊了就跟著走。第一步拿到工具。在命令行里克隆倉庫git clone https://gitcode.com/gh_mirrors/on/onenote-md-exporter第二步補(bǔ)上轉(zhuǎn)換引擎。進(jìn)入src/OneNoteMdExporter/pandoc/目錄把里面的pandoc-3.8.3-windows-x86_64.zip解壓讓pandoc.exe和壓縮包待在同一個(gè)文件夾。沒有這一步程序會(huì)找不到格式轉(zhuǎn)換器。第三步讓 OneNote 就位。啟動(dòng) OneNote確認(rèn)要導(dǎo)出的筆記本已經(jīng)加載并完成同步。程序是讀實(shí)時(shí)狀態(tài)的筆記本沒打開可不行。第四步開始導(dǎo)出。最簡(jiǎn)單的方式是直接雙擊運(yùn)行OneNoteMdExporter.exe它會(huì)列出本機(jī)所有筆記本讓你勾選要導(dǎo)出的對(duì)象、選擇格式還能現(xiàn)場(chǎng)調(diào)整高級(jí)設(shè)置。等它跑完會(huì)自動(dòng)彈出導(dǎo)出文件夾。想要批量或無人值守就用命令行一次指定筆記本和格式OneNoteMdExporter.exe --notebook 我的筆記本 --format 1 --no-input這里的--format 1是 Markdown 文件夾格式--format 2是 Joplin 原始目錄格式--no-input表示全自動(dòng)、不需要任何交互。導(dǎo)出完成后你會(huì)得到類似這樣的目錄結(jié)構(gòu)我的筆記本/ ├─ 工作項(xiàng)目/ │ ├─ 需求文檔/ │ │ ├─ 需求評(píng)審.md │ │ └─ 技術(shù)方案.md │ └─ 周報(bào).md ├─ 生活隨筆.md └─ resources/ ├─ 截圖1.png └─ 附件.pdf頁面是.md文件圖片和附件統(tǒng)一收在resources文件夾里Markdown 內(nèi)部用相對(duì)路徑引用——放進(jìn) Obsidian 倉庫就能直接用不需要再改任何路徑。第一次運(yùn)行這些坑我先替你踩了小宇第一次跑就報(bào)了System.Runtime.InteropServices.COMException差點(diǎn)放棄。后來才知道這是程序沒能和 OneNote 組件握手常見原因就是本機(jī) Office 安裝有問題。這時(shí)候最省事的解法不是重裝 Office而是按doc/notebook-onepkg-export.md里的說明把筆記本導(dǎo)出成.onepkg包換一臺(tái)干凈的電腦導(dǎo)入后再導(dǎo)出 Markdown。效果一樣風(fēng)險(xiǎn)更低。還有幾個(gè)坑提前知道能省下不少時(shí)間導(dǎo)出后圖片是壞的多半是 OneNote 本地根本沒緩存圖片。到「文件 → 選項(xiàng) → 同步」里勾上下載所有文件和圖像強(qiáng)制同步一次再重新導(dǎo)出基本就能解決。密碼保護(hù)的分區(qū)變空了記得在導(dǎo)出前手動(dòng)解鎖鎖著的分區(qū)內(nèi)容不會(huì)進(jìn)入結(jié)果。手寫筆跡直接消失這是工具明確的邊界手寫內(nèi)容不支持轉(zhuǎn)換導(dǎo)出前心里要有數(shù)。文件名太長(zhǎng)導(dǎo)致路徑超限筆記本里有標(biāo)題超長(zhǎng)的頁面時(shí)可以在配置里把MdMaxFileLength調(diào)小一點(diǎn)從源頭避免 Windows 路徑過長(zhǎng)的報(bào)錯(cuò)。小宇跑順之后還總結(jié)出幾個(gè)進(jìn)階技巧你可以按需取用給 Obsidian 用的推薦組合把a(bǔ)ppSettings.json里的OneNoteLinksHandling設(shè)為ConvertToWikilinkOneNote 內(nèi)部鏈接變成[[雙鏈]]雙向鏈接直接可用ProcessingOfPageHierarchy保持HierarchyAsFolderTree層級(jí)就是文件夾AddFrontMatterHeader設(shè)為true每篇筆記自動(dòng)帶上創(chuàng)建/更新時(shí)間方便檢索。給 Joplin 用的推薦組合格式選 2鏈接策略換成ConvertToMarkdown導(dǎo)出后直接以原始目錄方式導(dǎo)入 Joplin標(biāo)簽和層級(jí)都能對(duì)上。一次性導(dǎo)出所有筆記本加個(gè)--all-notebooks參數(shù)它會(huì)忽略--notebook把所有筆記本挨個(gè)處理一遍OneNoteMdExporter.exe --all-notebooks --format 1 --no-input至于它為什么轉(zhuǎn)換得這么穩(wěn)小宇后來大致弄明白了程序先通過 OneNote COM 接口把每頁內(nèi)容導(dǎo)出成 DocX再用 Pandoc 把 DocX 翻譯成 Markdown最后跑一輪正則后處理修復(fù)格式毛刺。這種雙引擎 后處理的思路比他見過的任何單步轉(zhuǎn)換都穩(wěn)妥。出發(fā)前收好這份行動(dòng)清單如果你也動(dòng)了遷移的心思不妨按這個(gè)順序來克隆倉庫按上文把pandoc.exe解壓就位先拿一個(gè)最常用的小筆記本試跑全程開著 OneNote 等它同步完成對(duì)照appSettings.json里的配置項(xiàng)按你要去的平臺(tái)Obsidian 還是 Joplin調(diào)好鏈接策略導(dǎo)出完成后隨機(jī)抽查十幾篇帶表格、圖片的筆記確認(rèn)質(zhì)量遇到報(bào)錯(cuò)先看同目錄下的logs.txt再帶著日志去項(xiàng)目里提問或參與改進(jìn)。知識(shí)遷移從來不是一夜之間的事但好消息是最痛苦的那一步onenote-md-exporter 已經(jīng)幫你走完了。剩下的就是打開 Obsidian和那些老筆記好好重逢。想深入了解 Joplin 遷移細(xì)節(jié)可以翻翻doc/migration-to-joplin.md想?yún)⑴c翻譯或貢獻(xiàn)代碼doc/contribute.md里有完整的指南?！久赓M(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），僅供參考