歡迎使用 iOS 版 MWeb
MWeb 首先是一個 Markdown 編輯器,所使用的 Markdown 語法為 Github Flavored Markdown,簡稱 GFM,這是一種最為廣泛使用的 Markdown 語法之一。如果你不知道什麼是 Markdown,建議看一下附帶的 Markdown 語法官方說明 文檔。GFM 除了支持官方的語法外,還擴展了不少語法,具體情況會在本文後說明。這裡先介紹一下 iOS 版 MWeb 的基本使用方法。
iOS 版 MWeb 的編輯器介紹
自定義鍵盤

如上圖所示,iOS 版 MWeb 為方便輸入 Markdown 語法,自定義了一些按鈕,點擊上圖左邊的圖中的 (M) 按鈕,可以切換至右圖的效果,再按可以切換回來。有些不用先選中文字即可使用,比如說如果當前行是任務列表,點擊任務列表按鈕,會把當前行的任務標記為完成,再點則標記為未做。
編輯器樣式、預覽樣式、大綱視圖

如上圖左邊的圖所示,右上角的按鈕可以快速設置編輯器的字體大小和行高,更換編輯器樣式和預覽樣式。還有一個 「編輯器全屏模式」 的選項,開啓後,編輯和查看時,編輯器會全屏顯示。底部有五個按鈕,分別為:文檔大綱、收藏、切換預覽模式和編輯模式、新增、分享,如上圖右邊的圖是點擊文檔大綱按鈕的效果。
導出為圖片和 PDF、發佈服務、圖床功能

iOS 版 MWeb 跟 Mac 版一樣,也支持把文檔發佈到 Wordpress、Metaweblog API 、Evernote、Blogger 和 Medium。除了發佈到 Medium 外,其他都支持更新已發佈的文檔,發佈時,如果文檔中有圖片,也會自動上傳。如上圖左邊的圖所示,點擊分享按鈕即可使用此功能。另外,iOS 版 MWeb 還支持圖床,要使用這些功能,要先到設置頁面增加相關服務,如上圖右邊的圖所示。更詳細的使用說明,可參考以下三篇文章:
- iOS 版 MWeb 發佈到自建 Wordpress 和 Metaweblog API 使用指南
- iOS 版 MWeb 圖床功能及七牛圖床使用指南
- iOS 版 MWeb 圖床功能中自定義圖床的使用指南
iOS 版 MWeb 首頁及文檔管理介紹
首頁和打開外部文檔

上圖中,左邊的是首頁,首頁有最近使用的文檔和收藏內容這兩大塊。
最近使用只會顯示最近使用的 5 個文檔,包括文檔庫的文檔、iCloud 中的文檔、在手機本地的文檔,可以看邊上的圖標來識別文檔類型。
而收藏不只可以收藏文檔,還可以收藏文件夾、文檔庫的分類,只要是底加的工具欄中有 ✭ 的按鈕的項目,都可以收藏,基本上,除了首頁,都會有 ✭ 這個按鈕,如右邊的圖所示。
首頁底下的按鈕,分別為:首頁、文檔庫、iCloud 文檔、手機本地文檔、新增文檔。 其中,文檔庫按鈕要先在設置里啓用文檔庫,然後再在 Mac 端配置後,同步完後,才會顯示,配置方法後面會有說明。iCloud 文檔按鈕在 iCloud 啓用時才會顯示。
點擊首頁的新增文檔按鈕,可以打開 iCloud Drive 和其他 App 中的 Markdown 文檔,如上圖右邊的圖所示。要注意的時,打開的文檔不會出現在首頁的最近使用中,也不能收藏。點擊手機本地文檔按鈕,會顯示如下圖左邊的圖所示的本機文檔。
文檔管理

在本機文檔中,如果要重命名或者刪除文件或文件夾,請左滑相關文件或文件夾,在出來的按鈕中選擇重命名或刪除即可,要注意的是,目前並不支持移動功能,這個功能將在 2.3.x 中支持,和 Dropbox 和 WebDAV 功能一併發布。
界面底部也有五個按鈕,分別是:回首頁、收藏、排序、新增文件夾、新增文檔。Mac 版的外部模式中,每個引入的文件夾都會有自己的設置,比如說設置新增文檔的默認擴展名、插入的圖片的保存文件夾名等,iOS 版也是有這個功能。區別是,iOS 版不用引入,默認為最頂層的文件夾可以設置。如右圖,點擊 demo folder 文件夾中的 (i) 這個按鈕即可進入設置,如上圖右邊的圖。
上圖右邊的圖中,可以設置插入的圖片保存的位置,默認是在當前文檔下的 media 文件夾里。文件夾名設置為空白,則會保存到當前文檔所在的文件夾下。如果把保存路徑設置為絕對路徑,則會把插入的圖片保存到最頂層的文件夾下的 media 文件夾內,而不管當前文檔的位置是在何處。
配置讓 iOS 版 MWeb 支持 Mac 版的文檔庫
首先說明一下,iOS 版 MWeb 僅支持查看、編輯、新增文檔庫的文檔,管理分類、刪除等等都不支持。這個是因為文檔庫用到了數據庫,非常不利於同步。
要支持文檔庫,首先在設置頁面中啓用 iCloud(默認已開啓),然後再啓用 MWeb for Mac 文檔庫。啓用文檔庫時,如果文檔庫沒有同步好,會跳出以下文字的提示:
請看看你 Mac 中的 iCloud Drive 里的 MWeb 所屬的文件夾內是否有名為 "mweb_documents_library" 的文件夾,如果有,請在 MWeb for Mac 中,打開 偏好設置 - 通用設置 - 文檔庫位置,把文檔庫另存到這個位置即可;如果沒有,只能耐心等待 iCloud 同步了。當你把 Mac 中的文檔庫另存好後,在 iOS 端也要同步完成才會看到文檔庫的文檔。
照著以上的說明做即可。另外,如果你一天後仍然沒有在 Mac 中的 iCloud Drive 中看到 MWeb 所屬的文件夾,可以試試在 iOS 的 系統設置 - iCloud - iCloud Drive 中關閉 MWeb,然後再打開看看。如果這種方法無效果,只能再等幾天了。如果都不能同步,請點設置頁面底部的 「郵件反饋」 按鈕反饋給我。也可以等支持 Dropbox 和 WebDAV 的版本發佈。
GFM 語法簡介和 MWeb 所支持的擴展語法
回車轉為換行
官方的語法規定結尾加 2 個以上空格加換行才會轉成換行,也就是 <br /> 標籤。MWeb 中有個選項可以直接把換行轉成 <br />,不用加上 2 個以上空格,這個選項默認是開啓的。如果要關閉,請在設置頁面關閉。
任務列表(Task lists)
Markdown 語法:
- [ ] 任務一 未做任務 `- + 空格 + [ ]`
- [x] 任務二 已做任務 `- + 空格 + [x]`
效果如下:
- 任務一 未做任務
- + 空格 + [ ] - 任務二 已做任務
- + 空格 + [x]
圖片大小及對齊
官方和 GFM 都不支持圖片大小控制及對齊設置,MWeb 引入的特別的語法來設置圖片寬度和居左、居右、居中。如: 這樣表示設置圖片寬度為 450。其中 -w450 為設置語法,生成 HTML 時會自動移除。w 表示設置寬度,居左為:-l400,居右為 -r400,居中為 -c400,比如設置一圖片寬度為 500 並居中:。 可以看出,MWeb 引入的語法的特點是兼容原來的語法和僅支持設置寬度。
多行或者一段代碼
Markdown 語法:
function fancyAlert(arg) {
if(arg) {
$.facebox({div:'#foo'})
}
}
效果如下:
function fancyAlert(arg) {
if(arg) {
$.facebox({div:'#foo'})
}
}
這個語法目前在 MWeb 中使用,必須前後空一行,才會正確解析。我覺得,在寫 Markdown 文檔過程中,運用空行很有必要,基本上,塊級元素(標題、列表、引用、代碼塊、表格、段落等),都建議前後空一行。
表格
Markdown 語法:
第一格表頭 | 第二格表頭
--------- | -------------
內容單元格 第一列第一格 | 內容單元格第二列第一格
內容單元格 第一列第二格 多加文字 | 內容單元格第二列第二格
效果如下:
| 第一格表頭 | 第二格表頭 |
|---|---|
| 內容單元格 第一列第一格 | 內容單元格第二列第一格 |
| 內容單元格 第一列第二格 多加文字 | 內容單元格第二列第二格 |
刪除線
Markdown 語法:
加刪除線像這樣用: 刪除這些
效果如下:
加刪除線像這樣用: 刪除這些
LaTeX
Markdown 語法:
塊級公式:
$$ x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a} $$
\\[ \frac{1}{\Bigl(\sqrt{\phi \sqrt{5}}-\phi\Bigr) e^{\frac25 \pi}} =
1+\frac{e^{-2\pi}} {1+\frac{e^{-4\pi}} {1+\frac{e^{-6\pi}}
{1+\frac{e^{-8\pi}} {1+\ldots} } } } \\]
行內公式: $\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$
效果如下(在設置頁面中啓用 LaTeX 才會看到效果,默認為啓用):
塊級公式:
\[ x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a} \]
\[ \frac{1}{\Bigl(\sqrt{\phi \sqrt{5}}-\phi\Bigr) e^{\frac25 \pi}} =
1+\frac{e^{-2\pi}} {1+\frac{e^{-4\pi}} {1+\frac{e^{-6\pi}}
{1+\frac{e^{-8\pi}} {1+\ldots} } } } \]
行內公式: \(\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N\)
腳注(Footnote)
Markdown 語法:
這是一個腳注:[^sample_footnote]
效果如下:
這是一個腳注:1
注釋和閱讀更多
注 閱讀更多的功能只用在文檔庫生成靜態網站或發佈到 Wordpress 博客時,插入時注意要後空一行。
TOC
Markdown 語法:
[TOC]
效果如下:
-
這裡是腳注信息 ↩
沒有留言:
張貼留言