Markdown Reader 操作手冊
這是團隊共用的 Markdown 文件閱讀器。登入後可以瀏覽共享資料夾裡的 SOP，也可以直接編輯、插入圖片、上傳新文件和下載。每一章都有動畫示範，旁邊的步驟會跟著動畫同步亮起。
1登入與登出
所有文件都需要登入才能看。
- 輸入 帳號 和 密碼，按「登入」。
- 如果登入畫面有「使用 Google 登入」按鈕，也可以用公司授權的 Google 帳號登入。只有管理員加入允許名單的帳號才能用 Google 登入。
- 登出：按右上角「⋯」→「登出」。
- 想看誰登入過：按「⋯」→「登入紀錄」，會列出最近 200 筆成功和失敗的紀錄。
提醒登入狀態最多保留 8 小時。伺服器重新啟動後也需要重新登入。
2找到並開啟文件
檔案清單平常是收起來的，讓內容有最大的閱讀空間。
- 按左上角 「☰ 檔案」檔案清單會從左邊滑出來。
- 在搜尋欄輸入關鍵字會比對資料夾和檔名，不分大小寫。
- 點一下要看的文件清單會自動收起來。
- 開始閱讀頂端會顯示目前的檔名。
其他小技巧
- 點資料夾名稱可以展開或收合。搜尋時，有結果的資料夾會自動展開。
- 在搜尋欄按 Esc 清除關鍵字。清單開著時，再按一次 Esc 會關閉清單。
- 點清單外面的灰色區域，或按清單右上角的 ✕，也能關閉清單。
3閱讀與進度條
左下角的小膠囊是閱讀進度條，會一直顯示目前讀到百分之幾。
- 看左下角的百分比例如 37%，代表讀到大約三分之一。
- 按住進度條上的圓點手機用手指按住也可以。
- 往右拖到想去的位置拖到中間就是大約 50%。
- 放開，畫面就跳到那裡直接點一下進度條也能跳過去。
- 點一下進度條後，用 ← → 方向鍵每次移動 5%。
- 往下捲之後，右下角會出現「回到最上面」按鈕。
- 文件很短、不需要捲動時，進度條會自動隱藏。
- 文件裡的目錄連結（例如
[第二章](#第二章)）點了會直接捲到那個標題。
4全螢幕閱讀
整個螢幕只剩文件內容，適合專心閱讀或分享畫面。
- 按「⋯」→ 「全螢幕閱讀」
- 畫面只剩內容頂端列和所有按鈕都會藏起來。
- 滑鼠移到 右上角 叫出按鈕有「退出全螢幕閱讀」和兩個簡報按鈕。
- 移到 右下角 叫出「回到最上面」約 3 秒不動就會自動收起。
- 手機和平板上，用手指點一下右上角或右下角就能叫出按鈕。
- 按 Esc 可以直接退出全螢幕閱讀。
- 全螢幕閱讀時只能看、不能編輯。左下角的進度條仍然可以用。
注意iPhone 的 Safari 不允許網頁進入真正的全螢幕。在 iPhone 上只會變成滿版內容，瀏覽器的網址列還是會在。
5簡報模式
把文件自動切成一頁一頁的投影片，適合開會時講解 SOP。
- 先進入「全螢幕閱讀」。
- 滑鼠移到右上角，按 「開始簡報」從第一頁開始，或按 「從此頁開始簡報」從你目前讀到的地方開始。
- 換頁：→ ↓ PageDown 空白鍵 下一頁，← ↑ PageUp 上一頁。也可以按右下角的箭頭按鈕。
- 按 Esc 或右下角的 ✕ 結束簡報，會回到你看到的那個位置。
- 遇到標題（
#、##…）或分隔線（---）會自動換頁，內容太多時也會自動拆頁。 - 滑鼠滾輪也能換頁：捲到單頁內容的最底部再往下捲，就會切到下一頁。
- 按住 Ctrl 再滾動滾輪可以放大或縮小，範圍是 60% 到 180%。
6編輯與儲存
共享資料夾裡的文件可以直接在網頁上修改，改完存回伺服器，其他同事重新開啟就會看到。
- 開啟文件後，按右上角 「編輯」畫面會變成可以打字的 Markdown 原始內容。
- 直接修改內容
- 按 「儲存」，或按 Ctrl/⌘ + S
- 看到綠色的「已儲存」就完成了按「預覽」回到閱讀畫面。
沒存就切換？有未儲存的修改時，切換到別的文件、關閉或重新整理頁面，系統都會先跟你確認，避免辛苦打的內容不見。
為什麼「儲存」是灰的？只有從共享資料夾開啟的文件才能存回伺服器。用「選擇 Markdown 檔案」開啟的本機檔案只能預覽，不能儲存。
7圖片管理
可以上傳圖片、把圖片插入文件，或刪除不用的圖片。
- 按「☰ 檔案」，展開最下面的 「圖片資源」
- 找到要用的圖片或按「上傳圖片」，新圖片會存到目前文件所在的資料夾。
- 按圖片旁的 「插入」會自動切到編輯模式，插在游標的位置。
- 記得按 「儲存」沒儲存的話，插入的圖片不會存進文件。
- ● 內文已引用 代表目前的文件有用到這張圖，○ 未引用 則是沒用到。
- 直接點縮圖也能插入圖片。
- 上傳和刪除圖片時，需要先開啟一份共享資料夾裡的文件。
刪除前請確認按「刪除」會直接從伺服器刪掉這張圖片，無法復原。其他文件如果也用到這張圖，那些文件裡的圖片就會顯示不出來。
8上傳檔案（加入，不覆蓋）
把新的文件或圖片加入共享資料夾，其他檔案都不受影響。
- 按「⋯」→ 「上傳檔案（加入，不覆蓋）」
- 確認 「上傳到」 哪個資料夾預設是你目前開著的文件所在的資料夾，也可以另外新增子資料夾。
- 按 「選擇檔案」 或 「選擇資料夾」
- 按 「開始上傳」，看每個檔案的結果
「選擇檔案」和「選擇資料夾」怎麼選？
| 情況 | 建議 |
|---|---|
| 只有一份 Markdown，或幾張零散的圖片 | 選擇檔案（可以多選） |
文件有自己的圖片資料夾，例如 新版SOP.md 加上 新版SOP_images/ | 選擇資料夾，資料夾裡的結構會原封不動保留，圖片位置才對得上 |
上傳結果代表什麼？
| 狀態 | 意思 |
|---|---|
| 已上傳 | 新檔案已經加入。 |
| 已存在，已略過 | 同一個位置已經有同名檔案，原本的檔案保留不動。想取代的話，把「遇到同名檔案」改成「覆蓋原本的檔案」再上傳一次。 |
| 已覆蓋 | 你選了覆蓋，原本的檔案已被新檔取代。 |
| 已上傳，但有 N 張圖片找不到 | 文件上傳成功了，但裡面引用的圖片在伺服器上找不到。通常是圖片資料夾沒有一起傳，請改用「選擇資料夾」補傳。 |
| 不支援，會略過 | 只接受 Markdown（.md）和圖片（png、jpg、gif、webp、svg、bmp、avif）。 |
限制單一檔案最大 50 MB。資料夾名稱不能包含 ..。
9取代整個共享資料夾
用一個資料夾把伺服器上的共享資料夾整個換掉。選單裡用紅字標示。
- 按「⋯」→「取代整個共享資料夾」。
- 選擇電腦上的資料夾。
- 系統會再跟你確認一次，按「確定」才會開始，按「取消」什麼都不會改變。
- 上傳完成後，會自動開啟第一份文件。
會刪掉伺服器上原本的所有檔案包括其他同事上傳的文件、在網頁上修改過的內容和圖片。只想新增或更新幾份文件時，請用上一章的「上傳檔案（加入，不覆蓋）」。
10下載
把文件存到自己的電腦，可以只下載一份，也可以整包下載。
- 先開啟要下載的文件只下載整個共享資料夾時不用。
- 按右上角 「⋯」
- 在「下載」區選擇要下載什麼
- 檔案會存到電腦的「下載」資料夾
| 選項 | 內容 | 適合 |
|---|---|---|
| 下載此文件（.md） | 只有這份 Markdown 文字檔 | 只需要文字內容 |
| 下載此文件含圖片（.zip） | 這份文件加上它引用到的所有圖片 | 要寄給別人，或在其他電腦上完整閱讀 |
| 下載目前資料夾（.zip） | 目前文件所在資料夾裡的所有文件和圖片 | 備份或交接某一類 SOP |
| 下載整個共享資料夾（.zip） | 伺服器上的全部文件和圖片 | 完整備份 |
- 壓縮檔裡的資料夾結構會保留，解壓縮後用任何 Markdown 編輯器打開，圖片都能正常顯示。
- 下載的是伺服器上已儲存的版本。如果你正在編輯還沒儲存，系統會先提醒你。
11開啟本機檔案（不上傳）
想快速看一下電腦裡的 Markdown，又不想放到共享資料夾時使用。
- 按「⋯」→「選擇 Markdown 檔案」，選擇電腦裡的 .md 檔。
- 也可以直接把 .md 檔 拖曳到網頁上。
只能預覽本機檔案不會上傳，其他人看不到，也不能「儲存」。文件裡用相對路徑引用的圖片不會顯示，要完整閱讀請改用「上傳檔案」。
12快捷鍵一覽
| 按鍵 | 在哪裡 | 功能 |
|---|---|---|
| Ctrl/⌘ + S | 編輯中 | 儲存 |
| Esc | 檔案清單、選單 | 關閉（在搜尋欄時先清除關鍵字） |
| Esc | 全螢幕閱讀、簡報 | 退出 |
| → ↓ PageDown 空白鍵 | 簡報 | 下一頁 |
| ← ↑ PageUp | 簡報 | 上一頁 |
| Ctrl + 滾輪 | 簡報 | 放大、縮小 |
| ← → | 點選進度條後 | 往前、往後 5% |
13常見問題
文件裡的圖片顯示不出來？
圖片路徑是以「文件所在的資料夾」為起點計算的。最常見的原因是圖片資料夾沒有一起上傳，或圖片放在上一層資料夾，但文件裡沒寫 ../。請用「上傳檔案」→「選擇資料夾」把整個資料夾一起傳上來，上傳結果也會提示缺了幾張圖。
「儲存」、「刪除」或「上傳圖片」按不下去？
這些功能需要先開啟一份共享資料夾裡的文件。用「選擇 Markdown 檔案」開啟的本機檔案只能預覽。
上傳後顯示「已存在，已略過」？
代表同一個位置已經有同名檔案，系統為了保護原本的內容沒有覆蓋。確定要取代的話，把「遇到同名檔案」改成「覆蓋原本的檔案」再上傳一次。
為什麼突然要我重新登入？
登入狀態最多保留 8 小時，伺服器重新啟動或更新後也需要重新登入。正在編輯的內容請記得先儲存。
手機上可以用嗎？
可以。閱讀、搜尋、進度條（用手指拖曳）和全螢幕閱讀都能在手機上使用。編輯和上傳比較適合在電腦上操作。
怎麼再打開這份手冊？
隨時按右上角「⋯」→「操作手冊」。