文檔的頁面用區塊編輯器來寫。這一頁說明怎麼切換到編輯模式、怎麼加各種區塊,以及每一種特殊區塊的用法。
檢視與編輯
一個頁面不是在檢視模式,就是在編輯模式。頁面上方列有一個模式按鈕,它上面的字會是下面其中一個:
- 「切換編輯模式」:現在是檢視模式,按它會切換到編輯模式。
- 「切換檢視模式」:現在是編輯模式,按它會切換到檢視模式。
- 「已鎖定」:這一頁鎖定了,按鈕是灰的。要編輯,請先在「…」選單關掉「鎖定頁面」,請看頁面的「…」選單。
- 「僅檢視」:你只有「檢視」,按鈕是灰的,不能進入編輯模式。
裝置沒有網路連線時,這個按鈕不會出現,那裡會顯示「目前離線,只能閱讀」:頁面只能閱讀,Ctrl+Shift+E 也不會切換模式。請看一起編輯與離線閱讀。
在頁面的任何地方按 Ctrl+Shift+E(Mac 是 Cmd+Shift+E),也可以切換模式。
- 打開文檔時,頁面是檢視模式。你切換過的模式,會跟著你到下一個打開的頁面。
- 鎖定的頁面,打開時一定是檢視模式。
- 用側邊欄的「+」,或用「/」選單的「新的頁面」建立的頁面,打開時是編輯模式。
只有在編輯模式、頁面沒有鎖定、裝置有網路連線,而且你是擁有者或有「編輯」時,才能打字。 誰有「編輯」,請看誰可以做什麼。
標題
在編輯模式,頁面最上面的標題是一個文字框。你停下來不打字一下子之後,它就會自己存好,側邊欄上的名字也會跟著改。還沒存好就換到別的頁面時,標題會在換頁時馬上存好。標題框清空時不會存,頁面會保留原本的名字。
- 在標題框按 Enter:標題會從游標的地方切開,後面的字變成內文的第一行。
- 在標題框按 ↓:游標移到內文。
- 在內文第一行按 ↑:游標回到標題。
- 內文的第一行是一般的文字時,在它的最前面按 Backspace:這一行會接到標題後面。
內文
內文會自己存,沒有儲存按鈕。存的時候出了問題,標題下面會出現一行英文字,這行字是什麼意思、這時要怎麼做,請看一起編輯。
游標所在的空白行會顯示「輸入 Markdown 語法或 '/' 選擇區塊」。
- 在檢視模式按一個網頁連結,會在新的分頁打開它。
- 連到另一個文檔頁面的頁面連結,例如「新的頁面」放進來的那種,不管在哪一種模式,按了都會在文檔裡打開那一頁。用完整網址寫成的連結,例如貼上「複製連結」複製的網址,就和一般的網頁連結一樣。
區塊與「/」選單
頁面由一個一個的區塊組成。一行文字、一個標題、一段引用、清單的一項、一張圖片、一條分隔線、一個程式碼區塊或一個表格,都是一個區塊。
在一行的開頭,或在一個空格後面打「/」,會打開「選擇區塊」選單。繼續打字,可以篩選選單裡的項目。在表格或程式碼區塊裡打「/」,不會打開選單。
選單裡的項目,依序是:
- 「文字」
- 「大標題」、「中標題」、「小標題」
- 「引用區塊」
- 「項目清單」、「數字清單」、「待辦清單」
- 「程式碼區塊」
- 「分隔線」
- 「目錄」
- 「表格」
- 「超連結」
- 「上傳圖片」、「上傳檔案」
- 「網路書籤」
- 「新的頁面」:只有文檔有。它會在這一頁底下建立一個子頁面,並在這裡放一個連到它的頁面連結,請看子頁面。
每一行都有一句短短的提示,有幾句是英文的。游標所在的區塊是哪一種,那一行就會有一個小圓點。沒有符合的項目時,選單會寫 'No block found'。
Markdown 寫法
在一行的開頭打下面這些字,會直接變成那一種區塊:
#再打一個空格:大標題##再打一個空格:中標題###再打一個空格:小標題>再打一個空格:引用區塊*或-再打一個空格:項目清單1.再打一個空格:數字清單[]再打一個空格:待辦清單```再打一個空格:程式碼區塊---:分隔線
貼上 Markdown 文字時,它也會變成區塊。
文字工具列
在編輯模式選取一些字時,字的上方會出現一排小圖示按鈕,游標指著時才會顯示名字:Bold、Code、Italic、Underline、「項目清單」、「編號清單」、「待辦清單」和 Link。選起的是一整個區塊(例如一張圖片或一條分隔線),或是一個區塊組時,這排按鈕不會出現。
在清單裡,按 Tab 可以把一項往內縮一層,按 Shift+Tab 往外移一層。每一種清單都可以放在另一種清單裡,例如在項目清單裡放一個待辦清單。
小圓鈕、區塊組與拖曳
在編輯模式,滑鼠指著哪一行,那一行的左邊就會出現一個小圓鈕。游標指著小圓鈕時,會顯示它的名字:
- 在空白的一行,它是「+」,名字是「新增區塊」。按它會打開「選擇區塊」選單。
- 在其他的行,它是一個握把,名字是「操作區塊」。在程式碼區塊上,它一定是握把。
按「操作區塊」會打開一個選單:
- 「變更區塊」:選「文字」、「大標題」、「中標題」、「小標題」、「引用區塊」、「項目清單」、「數字清單」、「待辦清單」或「程式碼區塊」時,會把這個區塊改成那一種。選其他的種類時,多半會在這一行下面加一個新的區塊。
- 「複製」:在這個區塊的正下方,再放一個一樣的區塊。它不會複製到剪貼簿。
- 「刪除」:刪掉這個區塊。
拖曳握把可以移動區塊,一條藍線會告訴你它會放在哪裡。清單裡的一項也可以單獨拖曳。在表格裡,握把移動的是整個表格。
區塊組
區塊組是兩個以上、相鄰的區塊,一起被選起來。選出一個區塊組的方法:
- 按 Ctrl+A(Mac 是 Cmd+A):選起每一個區塊。
- 按 Shift+↑ 或 Shift+↓:一次多選或少選一個區塊。
- 在文字左邊的空白處按下去,拖出一個框:框碰到的區塊都會被選起來。按下去但沒有移動,就只是一般的點一下。
選起一個區塊組之後:
- 「操作區塊」的選單,會作用在組裡的每一個區塊上。
- 「變更區塊」只會列出可以改變這些區塊的種類,不會列出會把它們換掉的種類。
- 拖曳握把,會移動整個區塊組。
- 按 Backspace 或 Delete,會刪掉整個區塊組。
- 按 Esc,會取消選取,游標會停在組裡的第一個區塊。
小圓鈕、它的選單和拖出來的框,只有在編輯模式才會出現。
特殊區塊
程式碼區塊
- 游標指著程式碼區塊時,右上角會出現一個小圖示,游標指著它時顯示「複製程式碼」。按它會複製裡面的程式碼。檢視模式和編輯模式都有。
- 開頭的
```後面緊接著寫語言的名字,例如```js,程式碼就會有顏色。會有顏色的語言名字是js、javascript、jsx、ts、typescript、tsx和json。寫其他名字或沒有寫時,程式碼不會有顏色;很長的程式碼區塊也不會有顏色。 - 在程式碼區塊裡第一次按 Ctrl+A(Mac 是 Cmd+A),只會選起裡面的程式碼。
表格
「表格」會建立一個小表格,第一列是標題列。
- 表格的格子裡只能放純文字,不能放標題、清單或圖片。
- 欄的寬度可以拖曳調整。
- 在編輯模式,游標在表格裡時,表格旁邊會出現幾個小圖示按鈕,游標指著時才會顯示名字:「新增欄」、「新增列」、「刪除這一欄」、「刪除這一列」和「刪除整個表格」。
- 選起兩個以上的格子時,會出現「合併」。
圖片與檔案
- 「上傳圖片」:一次可以選很多張圖片。每一張最大 10 MB。
- 「上傳檔案」:一次可以選很多個。不是圖片的檔案,什麼種類都可以,每一個最大 20 MB。 每一個會顯示成一個可以下載的小方塊。
- 用「上傳檔案」選的圖片,會當成圖片上傳,和「上傳圖片」一樣:它會顯示成圖片,上限也是圖片的上限。圖片只能是 jpg、jpeg、png、gif、bmp 或 webp,其他種類的圖片(例如 svg)用哪一個按鈕都傳不上去。
- HEIC 的照片(例如 iPhone 拍的照片)是例外:網站會在上傳前先把它轉成 JPEG,所以用哪一個按鈕選、或直接貼上,都傳得上去,也會顯示成圖片。上限算的是轉好的 JPEG。
有些沒有上傳成功時,畫面的角落會跳出一則訊息,先說有幾個,後面接著「個檔案沒有上傳成功」,並說可能是檔案太大,或是網路斷了。網路斷了時,請再選一次那幾個檔案。但圖片的種類不對、HEIC 的照片轉不成 JPEG、檔案超過上限,或你已經不能編輯這一頁時,再選一次也一樣會失敗。
游標指著一張圖片時,圖片的兩邊會出現可以拖曳的調整條,用來改變圖片的大小;右上角還有一個小圖示「對齊方式」,按它會出現「靠左」、「置中」和「靠右」這些小圖示。這些名字都是游標指著時才會顯示。它們只有在頁面可以編輯時才會出現。
從別的網站貼上一張圖片或一個檔案時,網站會試著把它複製一份存起來。複製成功時,以後原本的網址不見了,這裡的連結也不會壞掉。複製失敗時,它還是連到原本的網站,也不會有任何訊息,所以之後還是可能壞掉。
從其他程式貼上的圖片,有些用的是瀏覽器打不開的網址。剪貼簿裡也有這張圖片的檔案時,網站會把那個檔案存起來用。沒有這個檔案時,這張圖片會從頁面上拿掉,並跳出一則訊息,先說有幾張,後面接著「張圖片無法複製過來」。
加圖片和檔案,要是這一頁的擁有者或有「編輯」,而且頁面沒有鎖定。
裝置沒有網路連線時,檔案的小方塊仍然顯示檔名,但按它不會打開檔案,會顯示「目前離線,連線後才能打開檔案。」。沒有網路時哪些圖片還看得到,請看離線閱讀。
網路書籤
「網路書籤」會打開瀏覽器自己的一個小框,寫著 'Paste a link to bookmark'。貼上網址之後,網站會讀取那個網址的預覽,做成一張預覽卡片。讀不到時,會顯示「無法讀取這個連結」。
超連結
「超連結」會打開瀏覽器自己的一個小框,寫著 'Link URL'。貼上網址,就會加上一個連結。
在編輯模式,游標指著一個連結時,會打開一個小框:
- 一個網址框,裡面的灰字是「貼上連結」。改好網址之後按 Enter 就會套用;按 Esc 會關掉小框。
- 幾個小圖示按鈕,游標指著時才會顯示名字:「開啟連結」、「複製連結」和「移除連結」。
目錄
「目錄」會列出這一頁的標題,按一個標題就會跳到那裡。
- 這一頁還沒有標題時,目錄會寫「加入標題後,這裡會列出目錄」。
- 沒有字的標題,在目錄裡會顯示成「未命名標題」。