Markdown 編輯器說明
東西存在哪裡
打的字存在這台瀏覽器的 IndexedDB 裡,沒有任何一個位元會送到伺服器。 這代表:
- 關掉分頁、重開電腦,文件都還在
- 換一台電腦、換一個瀏覽器,就是空的
- 「清除瀏覽資料 / 網站資料」會一併刪掉全部文件,而且沒有垃圾桶
- 無痕視窗關掉就沒了
所以備份不是加分項,是必要的。工具列右邊的「備份」就是做這件事。
三種備份
| 方式 | 得到什麼 | 什麼時候用 |
|---|---|---|
匯出備份檔 .json | 一個檔案,含全部文件、識別碼、時間 | 最完整的還原來源 |
全部打包 .zip | 每份文件一個 .md,外加一份備份檔 | 想在別的軟體讀、或長期封存 |
| Google Drive | 雲端資料夾,每份文件一個 .md + _backup.json | 想換裝置也拿得到、想自動化 |
還原採合併:以文件識別碼比對,兩邊都有就留比較新的那份。 所以同一個備份檔匯入兩次不會變成兩份,從別台機器匯入也是合併而不是覆蓋。
.md 檔匯入則一律當成新文件(.md 本身沒有識別碼可比對)。 把檔案直接拖進編輯器畫面也可以,.md、.txt、.json 都吃。
Google Drive 要先做一件事
Drive 備份走的是瀏覽器端的 Google 授權,不經過任何伺服器, 所以需要一組你自己的 OAuth Client ID。免費,大概五分鐘:
到 Google Cloud Console 建一個專案(名字隨便)。
「API 和服務 → 程式庫」搜尋 Google Drive API,按啟用。
「OAuth 同意畫面」選 外部,填應用程式名稱和你的信箱; 在「測試使用者」把自己的 Google 帳號加進去。 (範圍只用到
drive.file,屬於非敏感範圍,不需要送 Google 審核。)「憑證 → 建立憑證 → OAuth 用戶端 ID → 網頁應用程式」, 在「已授權的 JavaScript 來源」加上你會打開這頁的網址,例如:
https://latowolf.freeddns.org http://localhost:5173不需要填重新導向 URI。
把產生的 Client ID(
xxxx.apps.googleusercontent.com)貼到編輯器的備份面板裡,按儲存。
之後按「連結 Google Drive」授權一次就可以用了。
它會拿到什麼權限
只有 drive.file:這個頁面自己建立的檔案。 你雲端硬碟裡其他東西它讀不到,也列不出來。 資料夾叫「Markdown 編輯器」,裡面每份文件一個 .md, 另外一份 _backup.json 是還原時真正讀的那個。
存取權杖只留在這次瀏覽階段(sessionStorage),關掉瀏覽器就要重新授權一次。
自動備份
連結之後可以打開「閒置時自動備份」:停下來 90 秒、而且真的有變動時才會上傳, 不會在打字的時候插話,也不會在沒授權的時候跳視窗。
鍵盤
| 按鍵 | 動作 |
|---|---|
Ctrl + B | 粗體 |
Ctrl + I | 斜體 |
Ctrl + E | 行內程式碼 |
Ctrl + K | 連結 |
Ctrl + F | 在文件內搜尋 |
Ctrl + Z / Ctrl + Y | 復原 / 重做(每份文件各自獨立) |
Ctrl + Alt + N | 新增文件 |
Enter | 在清單、待辦、引言裡會自動接下一行 |
Tab | 縮排(清單裡就是降一層) |
Ctrl + S 不做事——存檔本來就是自動的,攔下來只是為了不要跳出瀏覽器的「儲存網頁」。
支援的語法
預覽用的是跟本站文章同一套外觀,語法涵蓋 CommonMark、表格、刪除線、 待辦清單(- [ ]),以及直接寫的 HTML。 本站文章另外掛的外掛(時間軸、MathJax、劇透)不在這個預覽裡。
貼上網址時如果剛好選著一段文字,會自動變成 Markdown 連結。