簡書的寫作體驗

iOS 版 MWeb 正式發(fā)布及簡介

2017/1/5

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

iOS 版 MWeb 的編輯器介紹

自定義鍵盤

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

編輯器樣式、預(yù)覽樣式、大綱視圖

如上圖左邊的圖所示，右上角的按鈕可以快速設(shè)置編輯器的字體大小和行高，更換編輯器樣式和預(yù)覽樣式。還有一個 “編輯器全屏模式” 的選項，開啟后，編輯和查看時，編輯器會全屏顯示。底部有五個按鈕，分別為：文檔大綱、收藏、切換預(yù)覽模式和編輯模式、新增、分享，如上圖右邊的圖是點擊文檔大綱按鈕的效果。

導(dǎo)出為圖片和 PDF、發(fā)布服務(wù)、圖床功能

iOS 版 MWeb 跟 Mac 版一樣，也支持把文檔發(fā)布到 Wordpress、Metaweblog API 、Evernote、Blogger 和 Medium。除了發(fā)布到 Medium 外，其他都支持更新已發(fā)布的文檔，發(fā)布時，如果文檔中有圖片，也會自動上傳。如上圖左邊的圖所示，點擊分享按鈕即可使用此功能。另外，iOS 版 MWeb 還支持圖床，要使用這些功能，要先到設(shè)置頁面增加相關(guān)服務(wù)，如上圖右邊的圖所示。更詳細的使用說明，可參考以下三篇文章：

* iOS 版 MWeb 發(fā)布到自建 Wordpress 和 Metaweblog API 使用指南

* iOS 版 MWeb 圖床功能及七牛圖床使用指南

* iOS 版 MWeb 圖床功能中自定義圖床的使用指南

iOS 版 MWeb 首頁及文檔管理介紹

首頁和打開外部文檔

上圖中，左邊的是首頁，首頁有最近使用的文檔和收藏內(nèi)容這兩大塊。

最近使用只會顯示最近使用的 5 個文檔，包括文檔庫的文檔、iCloud 中的文檔、在手機本地的文檔，可以看邊上的圖標來識別文檔類型。

而收藏不只可以收藏文檔，還可以收藏文件夾、文檔庫的分類，只要是底加的工具欄中有 ? 的按鈕的項目，都可以收藏，基本上，除了首頁，都會有 ? 這個按鈕，如右邊的圖所示。

首頁底下的按鈕，分別為：首頁、文檔庫、iCloud 文檔、手機本地文檔、新增文檔。其中，文檔庫按鈕要先在設(shè)置里啟用文檔庫，然后再在 Mac 端配置后，同步完后，才會顯示，配置方法后面會有說明。iCloud 文檔按鈕在 iCloud 啟用時才會顯示。

點擊首頁的新增文檔按鈕，可以打開 iCloud Drive 和其他 App 中的 Markdown 文檔，如上圖右邊的圖所示。要注意的時，打開的文檔不會出現(xiàn)在首頁的最近使用中，也不能收藏。點擊手機本地文檔按鈕，會顯示如下圖左邊的圖所示的本機文檔。

文檔管理

在本機文檔中，如果要重命名或者刪除文件或文件夾，請左滑相關(guān)文件或文件夾，在出來的按鈕中選擇重命名或刪除即可，要注意的是，目前并不支持移動功能，這個功能將在 2.3.x 中支持，和 Dropbox 和 WebDAV 功能一并發(fā)布。

界面底部也有五個按鈕，分別是：回首頁、收藏、排序、新增文件夾、新增文檔。Mac 版的外部模式中，每個引入的文件夾都會有自己的設(shè)置，比如說設(shè)置新增文檔的默認擴展名、插入的圖片的保存文件夾名等，iOS 版也是有這個功能。區(qū)別是，iOS 版不用引入，默認為最頂層的文件夾可以設(shè)置。如右圖，點擊 demo folder 文件夾中的 (i) 這個按鈕即可進入設(shè)置，如上圖右邊的圖。

上圖右邊的圖中，可以設(shè)置插入的圖片保存的位置，默認是在當前文檔下的 media 文件夾里。文件夾名設(shè)置為空白，則會保存到當前文檔所在的文件夾下。如果把保存路徑設(shè)置為絕對路徑，則會把插入的圖片保存到最頂層的文件夾下的 media 文件夾內(nèi)，而不管當前文檔的位置是在何處。

配置讓 iOS 版 MWeb 支持 Mac 版的文檔庫

首先說明一下，iOS 版 MWeb 僅支持查看、編輯、新增文檔庫的文檔，管理分類、刪除等等都不支持。這個是因為文檔庫用到了數(shù)據(jù)庫，非常不利于同步。

要支持文檔庫，首先在設(shè)置頁面中啟用 iCloud（默認已開啟），然后再啟用 MWeb for Mac 文檔庫。啟用文檔庫時，如果文檔庫沒有同步好，會跳出以下文字的提示：

請看看你 Mac 中的 iCloud Drive 里的 MWeb 所屬的文件夾內(nèi)是否有名為 "mweb_documents_library" 的文件夾，如果有，請在 MWeb for Mac 中，打開偏好設(shè)置 - 通用設(shè)置 - 文檔庫位置，把文檔庫另存到這個位置即可；如果沒有，只能耐心等待 iCloud 同步了。當你把 Mac 中的文檔庫另存好后，在 iOS 端也要同步完成才會看到文檔庫的文檔。

照著以上的說明做即可。另外，如果你一天后仍然沒有在 Mac 中的 iCloud Drive 中看到 MWeb 所屬的文件夾，可以試試在 iOS 的系統(tǒng)設(shè)置 - iCloud - 關(guān)閉 iCloud Drive，然后再重新打開。不行的話，可以試試在 Mac 中也關(guān)閉然后重新打開一下 iCloud Drive。

再不行的話，建議等支持 Dropbox 和 WebDAV 的版本出來再用。

GFM 語法簡介和 MWeb 所支持的擴展語法

回車轉(zhuǎn)為換行

官方的語法規(guī)定結(jié)尾加 2 個以上空格加換行才會轉(zhuǎn)成換行，也就是
標簽。MWeb 中有個選項可以直接把換行轉(zhuǎn)成
，不用加上 2 個以上空格，這個選項默認是開啟的。如果要關(guān)閉，請在設(shè)置頁面關(guān)閉。

任務(wù)列表（Task lists）

Markdown 語法：

- [ ] 任務(wù)一未做任務(wù) `- + 空格 + [ ]`

- [x] 任務(wù)二已做任務(wù) `- + 空格 + [x]`

效果如下：

* 任務(wù)一未做任務(wù) - + 空格 + [ ]

* 任務(wù)二已做任務(wù) - + 空格 + [x]

圖片大小及對齊

官方和 GFM 都不支持圖片大小控制及對齊設(shè)置，MWeb 引入的特別的語法來設(shè)置圖片寬度和居左、居右、居中。如：![圖片說明-w450](pic.jpg) 這樣表示設(shè)置圖片寬度為 450。其中 -w450 為設(shè)置語法，生成 HTML 時會自動移除。w 表示設(shè)置寬度，居左為：-l400，居右為 -r400，居中為 -c400，比如設(shè)置一圖片寬度為 500 并居中：![-c500](pic.jpg)。可以看出，MWeb 引入的語法的特點是兼容原來的語法和僅支持設(shè)置寬度。

多行或者一段代碼

Markdown 語法：

```js

function fancyAlert(arg) {

?if(arg) {

? ?$.facebox({div:'#foo'})

}

```

效果如下：

function fancyAlert(arg) {

? ?if(arg) {

? ? ? ?$.facebox({div:'#foo'})

? ?}

}

這個語法目前在 MWeb 中使用，必須前后空一行，才會正確解析。我覺得，在寫 Markdown 文檔過程中，運用空行很有必要，基本上，塊級元素（標題、列表、引用、代碼塊、表格、段落等），都建議前后空一行。

表格

Markdown 語法：

第一格表頭 | 第二格表頭

--------- | -------------

內(nèi)容單元格第一列第一格 | 內(nèi)容單元格第二列第一格

內(nèi)容單元格第一列第二格多加文字 | 內(nèi)容單元格第二列第二格

效果如下：

第一格表頭

第二格表頭

內(nèi)容單元格第一列第一格

內(nèi)容單元格第二列第一格

內(nèi)容單元格第一列第二格多加文字

內(nèi)容單元格第二列第二格

刪除線

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} } } } \\]

行內(nèi)公式： $\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$

效果如下（在設(shè)置頁面中啟用 LaTeX 才會看到效果，默認為啟用）：

塊級公式：

?b±

?4ac

√

(

–

√

??)

=1+

?2π

?4π

?6π

?8π

1+…

(

)

…

行內(nèi)公式：

Γ(n)=(n?1)!?n∈N

(

)

(

)

∈

腳注（Footnote）

Markdown 語法：

這是一個腳注：[^sample_footnote]

效果如下：

這是一個腳注：1

注釋和閱讀更多

comment more

注閱讀更多的功能只用在文檔庫生成靜態(tài)網(wǎng)站或發(fā)布到 Wordpress 博客時，插入時注意要后空一行。

TOC

Markdown 語法：

[TOC]

效果如下：

* iOS 版 MWeb 的編輯器介紹

? ?* 自定義鍵盤

? ?* 編輯器樣式、預(yù)覽樣式、大綱視圖

? ?* 導(dǎo)出為圖片和 PDF、發(fā)布服務(wù)、圖床功能

* iOS 版 MWeb 首頁及文檔管理介紹

? ?* 首頁和打開外部文檔

? ?* 文檔管理

* 配置讓 iOS 版 MWeb 支持 Mac 版的文檔庫

* GFM 語法簡介和 MWeb 所支持的擴展語法

? ?* 回車轉(zhuǎn)為換行

? ?* 任務(wù)列表（Task lists）

? ?* 圖片大小及對齊

? ?* 多行或者一段代碼

? ?* 表格

? ?* 刪除線

? ?* LaTeX

? ?* 腳注（Footnote）

? ?* 注釋和閱讀更多

? ?* TOC

1. 這里是腳注信息

/.blog-post

JiaThis Button END

三个男躁一个女,国精产品一区一手机的秘密,麦子交换系列最经典十句话,欧美国产综合欧美视频

簡書的寫作體驗

簡書的寫作體驗

推薦閱讀更多精彩內(nèi)容

三个男躁一个女,国精产品一区一手机的秘密,麦子交换系列最经典十句话,欧美 国产 综合 欧美 视频

簡書的寫作體驗

推薦閱讀更多精彩內(nèi)容

三个男躁一个女,国精产品一区一手机的秘密,麦子交换系列最经典十句话,欧美国产综合欧美视频