LANMA AGENT CLASS · L3 補充教材 補充 2 / 5

SUPPLEMENT 02 · FILE VISIBILITY

讓檔案櫃看得到所有抽屜 顯示 HTML/PPTX 等常用檔

你的 AI 明明寫好了一份 report.html,Obsidian 左邊卻一片空白——不是檔案不見了,是抽屜被鎖住沒打開。這一篇,我們把鎖打開。

TL;DR

設定(Settings)→ 檔案與連結(Files and links)→ 偵測所有檔案副檔名(Detect all file extensions),打開它。

打開後 .html、.pptx、.xlsx、.docx、.zip 全部現形。

記住一句話:設定只是把「看得到」打開;能不能編輯是另一回事。

// 01

為什麼你的檔案「不見了」

先講為什麼。Obsidian 出廠時很有個性:它預設只顯示自己認得的檔案——主要是 .md 筆記,加上少數幾種它能直接預覽的格式。其他的它一律當作「不關我的事」,直接藏起來不顯示。

注意「藏起來」三個字。你的 .pptx 沒有被刪掉、沒有被搬走,它好好躺在硬碟上的那個資料夾裡。只是 Obsidian 這扇玻璃門刻意不讓你看到它。這正是課堂講的——檔案櫃是你的,外觀是租來的:軟體怎麼顯示是它的事,檔案永遠是你的。

而在 L3 的用法裡,這件事會變得很痛:Claudian 裡的 AI 幫你寫了一份 HTML 報告放進 9_AI產出,你切回檔案列表想點開驗收——什麼都沒有。你會以為 AI 在騙你。

01

打開設定

左下角齒輪,或按 Cmd/Ctrl + ,(逗號)。

02

左欄選「檔案與連結(Files and links)」

它在左邊清單「選項(Options)」那一組裡,通常是第二、三項。

03

把「偵測所有檔案副檔名(Detect all file extensions)」打開

撥桿變成青色就對了。不用重開 Obsidian,回到左側檔案列表就會看到差別。

設定面板長這樣(示意)

設定 Settings → 檔案與連結 Files and links
偵測所有檔案副檔名 · Detect all file extensions
在檔案列表顯示所有檔案,不只是 Obsidian 支援的格式。
附件資料夾路徑 · Default location for new attachments
新貼進來的圖片、檔案要存去哪裡。
./_附件

*本站配色不等於你的 Obsidian 配色,撥桿位置與文字才是重點。這兩項就是課程 vault 的實際設定:showUnsupportedFiles: true、attachmentFolderPath: "./_附件"。

// 02

打開前 vs 打開後:左側檔案樹的差別

同一個資料夾、同一批檔案,差別只在那一個撥桿。左邊是預設狀態,右邊是打開之後。

打開前只看得到 .md
檔案 Files
DIR我的第二大腦  DIR0_收件匣  DIR9_AI產出   MD週報草稿.md   (沒了⋯⋯就這樣?)  MDAGENTS.md  MDINDEX.md  MDLOG.md

AI 說它產好了報告,你卻只看到一個 .md。於是你開始懷疑人生。

打開後全部現形
檔案 Files
DIR我的第二大腦  DIR0_收件匣  DIR9_AI產出   MD週報草稿.md   HTM客戶分析報告.html   PPT提案簡報.pptx   XLS報價試算.xlsx  MDAGENTS.md  MDINDEX.md  MDLOG.md

檔案一直都在。差的只是 Obsidian 願不願意讓你看到。

為什麼這件事在 L3 特別重要

9_AI產出 是課程 vault 的出貨口——AI 的工作區兼待審匣。你要驗收它交的東西,就必須看得到它交了什麼。看不到,「驗收」這一環就直接斷掉了。

// 03

看得到 ≠ 開得了:三層分類

打開撥桿之後,檔案都出現了。但「出現在列表」和「點下去能看」是兩件事。Obsidian 對各種檔案其實有三種態度,先建立這個分層,後面就不會亂。

任何檔案 進入 vault 偵測所有檔案副檔名 已打開 =檔案列表看得到 原生就能開 · 點兩下直接看 .md .pdf 圖片 音訊 影片 .canvas .base 裝外掛才能開 · 在分頁裡看 .html .htm 只能丟給外部程式 · 右鍵開啟 .pptx .xlsx .docx .zip …
層級副檔名怎麼開
原生就能開 .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。
Obsidian 只負責顯示,pptx 還是交給 PowerPoint。 它是你檔案櫃的玻璃門,不是全能的萬用編輯器——這是設計,不是缺陷。
// 04

.html 的兩種看法:Reader 還是 Preview?

HTML 是 L3 學員最常遇到的格式——因為 AI 產出的報告、儀表板、投影片,十有八九是一份單檔 HTML。Obsidian 原生開不了它,社群有兩個常見外掛,個性完全不同。它們可以同時裝,看不同的東西用不同的。

HTML Reader

外掛 id:obsidian-html-plugin · 1.0.15

  • 在 Obsidian 分頁裡直接開 .html/.htm,感覺跟開筆記一樣自然。
  • ⚠ 會擋掉 JavaScript。官方說明白:檔案裡 <script> 的程式碼「幾乎全部無法運作」,外部的 script 檔一樣被擋。
  • ⚠ 本地圖片不顯示。寫成 <img src="./圖.jpg"> 的本機圖片看不到——這是 Obsidian 本身的安全限制。
  • 結論:看純文字+表格+樣式的靜態報告,非常好用。

HTML Preview

外掛 id:live-preview · 1.0.3 · 桌面限定

  • 做法不一樣:它在你電腦上起一個本機小伺服器來預覽(=像用瀏覽器開網頁那樣)。
  • ✓ JavaScript 能跑。互動圖表、可以點的投影片、會動的東西都正常。
  • ✓ 檔案改了會自動重新整理,AI 一邊改你一邊看,不用手動重開。
  • 結論:看有互動的報告、課程投影片,用這個。

所以課程為什麼規定「純靜態、CSS 內嵌、無 JS」?

你可能已經在 vault 根目錄的 AGENTS.md(給 AI 看的新人手冊)裡看過這條規則。它不是美學潔癖,是從上面那張對照卡倒推出來的工程結論:

三條規則,三個理由

① 不靠 JavaScript——因為 HTML Reader 會擋掉。靠 JS 才畫得出來的圖表,在 Obsidian 裡會變成一片空白。

② CSS 內嵌在檔案裡(不要外連樣式檔)——這樣一份檔案就是完整的一份,搬到哪裡、寄給誰、十年後再打開,樣子都一樣。

③ 不要引用本地圖片——因為 Reader 顯示不出來。要放圖,請 AI 直接用 inline SVG 畫,或用 CSS 排出來。

這條規則的好處是雙保險:純靜態的 HTML 在 Reader、Preview、瀏覽器裡,三邊都正常。你不必記自己現在用的是哪個外掛。

交辦時直接把規格講給 AI 聽

你怎麼帶人,就怎麼帶 AI:講清楚、給邊界、驗收。所以請對 AI 說——「報告要輸出成單一檔案 HTML,CSS 全部內嵌,不要用 JavaScript,不要引用外部圖片,我要在 Obsidian 裡看。」寫成一句話,貼一次,之後都省事。

// 05

pptx/xlsx:右鍵,丟出去

簡報和試算表 Obsidian 開不了,這很正常——它沒打算變成 Office。打開「偵測所有檔案副檔名」之後,這些檔會乖乖出現在列表裡,讓你看得到、找得到、可以搬可以改名,要真的打開就右鍵一下丟給專業的。

右鍵選單在 提案簡報.pptx 上按右鍵

*選單項目會依你的作業系統與已裝外掛略有增減,青色那兩項是重點。

兩個動作,記這兩個就夠

A

用預設應用程式開啟

.pptx 交給 PowerPoint、.xlsx 交給 Excel、.docx 交給 Word。等於在檔案總管裡點兩下的效果,但你人不用離開 Obsidian。

B

顯示於系統檔案總管

直接跳到 Finder/檔案總管,並選取這個檔。要寄信附加、要壓縮、要另存,用這個最快——也順便讓你親眼確認檔案真的躺在硬碟上。

觀念收束

Obsidian 顯示不了 pptx,不代表 pptx 不該放進 vault。相反——它就該放進來。會議的簡報、報價的試算表跟你的會議筆記放在同一個專案資料夾,才叫做一個完整的檔案櫃。員工可以是別人訓練的,檔案櫃必須是你的。

// 06

兩個配套設定:附件放哪、以及「檔案沒出現」

一、附件資料夾:./_附件

當你把一張圖直接貼進筆記,Obsidian 會把圖片實體存成一個檔案。存去哪,由設定 → 檔案與連結 → 附件資料夾路徑(Default location for new attachments)決定。課程 vault 設的是 ./_附件。

那個開頭的 ./ 是關鍵,白話是「目前這則筆記所在的資料夾底下」。所以你在 1_專案/H客戶提案/ 寫筆記時貼圖,圖就會存到 1_專案/H客戶提案/_附件/。好處很直接:整個專案資料夾複製走,圖片跟著走,不會斷。如果所有圖都堆在 vault 根目錄一個大資料夾,搬走專案就會變成一堆破圖。

資料夾名稱開頭那個底線只是為了讓它在檔案列表排到最上面,方便你一眼跳過。沒有魔法。

二、AI 剛寫好的檔案沒出現?

這是 L3 的高頻事件。Claudian 裡的 AI 是從 Obsidian「外面」寫檔案的(它直接動硬碟),而 Obsidian 的檔案列表不見得會立刻察覺這種外部變動——尤其在網路磁碟、雲端同步資料夾上更明顯。檔案是真的寫好了,只是清單還沒更新。

三種解法,由懶到勤

① 裝 vault-file-refresh 外掛(1.2.0)——它會定期掃描外部新增/修改的檔案並自動補進列表。裝了就一勞永逸,課程 vault 已經裝好了。

② 點一下左側檔案列表,或收合再展開那個資料夾,通常就會重整。

③ 切換 vault 再切回來(等於強制重新掃描),或乾脆重開 Obsidian。

先別急著罵 AI

看不到檔案時,判斷順序永遠是這三步:撥桿打開了嗎 → 重整過了嗎 → 路徑找對了嗎。三步都做完還是沒有,才輪到懷疑 AI 沒寫。要確認得最快,就在檔案上按右鍵 → 顯示於系統檔案總管,用作業系統的眼睛看一次。

// 07

疑難排解

症狀原因怎麼修
左側檔案列表只看得到 .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_封存。看得到比看不到安全。
CHEAT SHEET

一頁帶走

  1. 一個撥桿解決一半問題:設定(Settings)→ 檔案與連結(Files and links)→ 偵測所有檔案副檔名(Detect all file extensions)。打開,全部現形。
  2. 看得到 ≠ 開得了。原生開:.md、.pdf、圖片、音訊、影片、.canvas、.base。外掛開:.html、.htm。其餘一律丟外部程式。
  3. HTML 兩種看法:HTML Reader(obsidian-html-plugin)=分頁裡看靜態、擋 JS、本地圖不顯示;HTML Preview(live-preview)=本機伺服器、JS 能跑、會自動重整。
  4. 交辦報告時直接講規格:單一檔案 HTML、CSS 內嵌、不用 JavaScript、不引用本地圖片。這樣三種看法都不會出包。
  5. Office 檔的兩個右鍵:用預設應用程式開啟(Open in default app)/顯示於系統檔案總管(Show in system explorer)。
  6. 看不到檔的排查順序:撥桿開了嗎 → 重整了嗎(vault-file-refresh)→ 路徑對嗎。附件請設 ./_附件,專案搬家圖片才跟得走。