SUPPLEMENT 02 · FILE VISIBILITY
你的 AI 明明寫好了一份 report.html,Obsidian 左邊卻一片空白——不是檔案不見了,是抽屜被鎖住沒打開。這一篇,我們把鎖打開。
設定(Settings)→ 檔案與連結(Files and links)→ 偵測所有檔案副檔名(Detect all file extensions),打開它。
打開後 .html、.pptx、.xlsx、.docx、.zip 全部現形。
記住一句話:設定只是把「看得到」打開;能不能編輯是另一回事。
先講為什麼。Obsidian 出廠時很有個性:它預設只顯示自己認得的檔案——主要是 .md 筆記,加上少數幾種它能直接預覽的格式。其他的它一律當作「不關我的事」,直接藏起來不顯示。
注意「藏起來」三個字。你的 .pptx 沒有被刪掉、沒有被搬走,它好好躺在硬碟上的那個資料夾裡。只是 Obsidian 這扇玻璃門刻意不讓你看到它。這正是課堂講的——檔案櫃是你的,外觀是租來的:軟體怎麼顯示是它的事,檔案永遠是你的。
而在 L3 的用法裡,這件事會變得很痛:Claudian 裡的 AI 幫你寫了一份 HTML 報告放進 9_AI產出,你切回檔案列表想點開驗收——什麼都沒有。你會以為 AI 在騙你。
左下角齒輪,或按 Cmd/Ctrl + ,(逗號)。
它在左邊清單「選項(Options)」那一組裡,通常是第二、三項。
撥桿變成青色就對了。不用重開 Obsidian,回到左側檔案列表就會看到差別。
*本站配色不等於你的 Obsidian 配色,撥桿位置與文字才是重點。這兩項就是課程 vault 的實際設定:showUnsupportedFiles: true、attachmentFolderPath: "./_附件"。
同一個資料夾、同一批檔案,差別只在那一個撥桿。左邊是預設狀態,右邊是打開之後。
AI 說它產好了報告,你卻只看到一個 .md。於是你開始懷疑人生。
檔案一直都在。差的只是 Obsidian 願不願意讓你看到。
9_AI產出 是課程 vault 的出貨口——AI 的工作區兼待審匣。你要驗收它交的東西,就必須看得到它交了什麼。看不到,「驗收」這一環就直接斷掉了。
打開撥桿之後,檔案都出現了。但「出現在列表」和「點下去能看」是兩件事。Obsidian 對各種檔案其實有三種態度,先建立這個分層,後面就不會亂。
| 層級 | 副檔名 | 怎麼開 |
|---|---|---|
| 原生就能開 | .md .pdf .canvas .base |
點兩下,直接在 Obsidian 分頁裡開。 |
| 原生就能開 | 圖片:png jpg jpeg gif bmp svg webp avif |
直接預覽,也能用 ![[檔名]] 嵌進筆記裡。 |
| 原生就能開 | 音訊:mp3 wav m4a ogg 3gp flac webm |
內建播放器直接播。錄音檔可以直接躺在 vault 裡。 |
| 原生就能開 | 影片:mp4 webm ogv mov mkv |
內建播放器直接播。 |
| 裝外掛能開 | .html .htm |
裝 HTML Reader 或 HTML Preview,才能在 Obsidian 分頁裡看。見下一節。 |
| 丟給外部程式 | .pptx .xlsx .docx .zip 其他一切 |
Obsidian 會告訴你無法預覽。右鍵 → 用預設應用程式開啟,交給 PowerPoint/Excel/Word。 |
HTML 是 L3 學員最常遇到的格式——因為 AI 產出的報告、儀表板、投影片,十有八九是一份單檔 HTML。Obsidian 原生開不了它,社群有兩個常見外掛,個性完全不同。它們可以同時裝,看不同的東西用不同的。
外掛 id:obsidian-html-plugin · 1.0.15
.html/.htm,感覺跟開筆記一樣自然。<script> 的程式碼「幾乎全部無法運作」,外部的 script 檔一樣被擋。<img src="./圖.jpg"> 的本機圖片看不到——這是 Obsidian 本身的安全限制。外掛 id:live-preview · 1.0.3 · 桌面限定
你可能已經在 vault 根目錄的 AGENTS.md(給 AI 看的新人手冊)裡看過這條規則。它不是美學潔癖,是從上面那張對照卡倒推出來的工程結論:
① 不靠 JavaScript——因為 HTML Reader 會擋掉。靠 JS 才畫得出來的圖表,在 Obsidian 裡會變成一片空白。
② CSS 內嵌在檔案裡(不要外連樣式檔)——這樣一份檔案就是完整的一份,搬到哪裡、寄給誰、十年後再打開,樣子都一樣。
③ 不要引用本地圖片——因為 Reader 顯示不出來。要放圖,請 AI 直接用 inline SVG 畫,或用 CSS 排出來。
這條規則的好處是雙保險:純靜態的 HTML 在 Reader、Preview、瀏覽器裡,三邊都正常。你不必記自己現在用的是哪個外掛。
你怎麼帶人,就怎麼帶 AI:講清楚、給邊界、驗收。所以請對 AI 說——「報告要輸出成單一檔案 HTML,CSS 全部內嵌,不要用 JavaScript,不要引用外部圖片,我要在 Obsidian 裡看。」寫成一句話,貼一次,之後都省事。
簡報和試算表 Obsidian 開不了,這很正常——它沒打算變成 Office。打開「偵測所有檔案副檔名」之後,這些檔會乖乖出現在列表裡,讓你看得到、找得到、可以搬可以改名,要真的打開就右鍵一下丟給專業的。
*選單項目會依你的作業系統與已裝外掛略有增減,青色那兩項是重點。
.pptx 交給 PowerPoint、.xlsx 交給 Excel、.docx 交給 Word。等於在檔案總管裡點兩下的效果,但你人不用離開 Obsidian。
直接跳到 Finder/檔案總管,並選取這個檔。要寄信附加、要壓縮、要另存,用這個最快——也順便讓你親眼確認檔案真的躺在硬碟上。
Obsidian 顯示不了 pptx,不代表 pptx 不該放進 vault。相反——它就該放進來。會議的簡報、報價的試算表跟你的會議筆記放在同一個專案資料夾,才叫做一個完整的檔案櫃。員工可以是別人訓練的,檔案櫃必須是你的。
./_附件當你把一張圖直接貼進筆記,Obsidian 會把圖片實體存成一個檔案。存去哪,由設定 → 檔案與連結 → 附件資料夾路徑(Default location for new attachments)決定。課程 vault 設的是 ./_附件。
那個開頭的 ./ 是關鍵,白話是「目前這則筆記所在的資料夾底下」。所以你在 1_專案/H客戶提案/ 寫筆記時貼圖,圖就會存到 1_專案/H客戶提案/_附件/。好處很直接:整個專案資料夾複製走,圖片跟著走,不會斷。如果所有圖都堆在 vault 根目錄一個大資料夾,搬走專案就會變成一堆破圖。
資料夾名稱開頭那個底線只是為了讓它在檔案列表排到最上面,方便你一眼跳過。沒有魔法。
這是 L3 的高頻事件。Claudian 裡的 AI 是從 Obsidian「外面」寫檔案的(它直接動硬碟),而 Obsidian 的檔案列表不見得會立刻察覺這種外部變動——尤其在網路磁碟、雲端同步資料夾上更明顯。檔案是真的寫好了,只是清單還沒更新。
① 裝 vault-file-refresh 外掛(1.2.0)——它會定期掃描外部新增/修改的檔案並自動補進列表。裝了就一勞永逸,課程 vault 已經裝好了。
② 點一下左側檔案列表,或收合再展開那個資料夾,通常就會重整。
③ 切換 vault 再切回來(等於強制重新掃描),或乾脆重開 Obsidian。
看不到檔案時,判斷順序永遠是這三步:撥桿打開了嗎 → 重整過了嗎 → 路徑找對了嗎。三步都做完還是沒有,才輪到懷疑 AI 沒寫。要確認得最快,就在檔案上按右鍵 → 顯示於系統檔案總管,用作業系統的眼睛看一次。
| 症狀 | 原因 | 怎麼修 |
|---|---|---|
| 左側檔案列表只看得到 .md,pptx/html 通通不見 | 「偵測所有檔案副檔名」還沒打開,Obsidian 把不認得的檔藏起來了。 | 設定 → 檔案與連結 → 打開偵測所有檔案副檔名(Detect all file extensions)。 |
| AI 說寫好了,撥桿也開了,還是沒看到新檔 | 檔案是從 Obsidian 外面寫進去的,檔案列表還沒重新掃描。 | 裝 vault-file-refresh;或點一下檔案列表、收合再展開資料夾;或重開 Obsidian。真的不放心就右鍵 → 顯示於系統檔案總管確認。 |
點 .html 沒反應,或跳出無法預覽 |
Obsidian 原生不會開 HTML,需要外掛。 | 裝 HTML Reader(分頁裡看靜態內容)或 HTML Preview(本機伺服器、JS 能跑)。臨時要看:右鍵 → 用預設應用程式開啟,丟給瀏覽器。 |
.html 開了,但圖表/互動元件一片空白 |
HTML Reader 會擋掉 JavaScript,靠 JS 才畫得出來的東西當然畫不出來。 | 改用 HTML Preview 看;或請 AI 重出一版純靜態、CSS 內嵌、無 JS 的報告。長久之計是後者。 |
.html 裡的圖片全破圖(顯示不出來) |
HTML Reader 不能讀本機圖片檔,這是 Obsidian 的安全限制,不是外掛壞了。 | 請 AI 用 inline SVG 或純 CSS 畫圖,不要外連 <img src="./圖.jpg">。或用 HTML Preview 看。 |
點 .pptx/.xlsx 只顯示無法預覽 |
正常,不是壞掉。Obsidian 沒有 Office 的解讀能力,只能顯示檔名。 | 右鍵 → 用預設應用程式開啟(Open in default app),交給 PowerPoint。這不是故障。 |
| 貼進筆記的圖片存到奇怪的地方,或搬走專案後變破圖 | 附件資料夾路徑設成 vault 根目錄的固定位置,圖片沒跟著專案走。 | 設定 → 檔案與連結 → 附件資料夾路徑改成 ./_附件(=存在目前筆記所在的資料夾底下)。 |
| 撥桿打開後檔案列表變得很亂,多出一堆看不懂的檔 | 你看到的是真相:資料夾裡本來就有這些檔(.DS_Store、暫存檔之類)。 |
忍住不要刪系統檔。想清爽一點就用資料夾分類,或把雜物歸到 4_封存。看得到比看不到安全。 |
.md、.pdf、圖片、音訊、影片、.canvas、.base。外掛開:.html、.htm。其餘一律丟外部程式。obsidian-html-plugin)=分頁裡看靜態、擋 JS、本地圖不顯示;HTML Preview(live-preview)=本機伺服器、JS 能跑、會自動重整。vault-file-refresh)→ 路徑對嗎。附件請設 ./_附件,專案搬家圖片才跟得走。