Twincl編輯器

「Twincl編輯器」可編輯文章或討論的內容。它有兩種模式:

  1. 文字模式 - 編輯原始的CommonMark文字
  2. HTML模式 - 直接編輯內容本身

於編輯區內按快速鍵 ALT+/⌘Command+/ ,可迅速在這兩種模式間切換。如要以文字模式編輯多個段落,請先反白選取段落即可。

CommonMark

Twincl編輯器採用CommonMark(一種Markdown語法)作為文件格式的語法。例如,上一節的原始CommonMark文字如下:

## Twincl編輯器

「Twincl編輯器」可編輯文章或討論的內容。它有兩種模式:

1. **文字模式** - 編輯原始的[CommonMark](http://commonmark.org)文字
1. **HTML模式** - 直接編輯內容本身

於編輯區內按快速鍵 `ALT`+`/` 或 `⌘Command`+`/` ,可迅速在這兩種模式間切換。
如要以**文字模式**編輯多個段落,請先反白選取段落即可。

以下是一些CommonMark的常用語法:

  1. 區塊語法
    • 空白行:分隔段落或區塊
    • # 標題## 標題 …… ###### 標題:標題
    • 1. 項目1) 項目:有編號項目
    • * 項目- 項目+ 項目:無編號項目
    • > 引言:引言區塊
    • ```:程式碼區塊的開始或結束
  2. 行內語法
    • [連結文字](連結網址): 連結
    • ![替代文字](圖片網址): 圖片
    • *強調*: 強調
    • **強調**: 強調
    • `程式碼`: 行內程式碼

關於CommonMark的說明,請參考commonmark.org網站,或中文的markdown.tw網站。

允許的HTML標籤及連結

CommonMark允許各種HTML標籤及連結,但這可能導致安全方面的問題。為兼顧安全性並彌補CommonMark在文件格式上的不足,Twincl編輯器允許以下的HTML標籤、屬性與連結:

  • 標籤: table, tbody, td, th, tr, br, font, a, b, i, u, s, sub, sup
  • 標籤屬性: align, bgcolor, border, color, size, width, height, name, title
  • 連結網址: http, https

圖片解說

CommonMark未定義「圖片解說」的語法。為使圖片解說與內文有所區隔,如果圖片後面緊接著<br>換行與強調文字,Twincl網站將視其為圖片解說,以稍淺的顏色顯示。例如以下第二行文字即為圖片解說(第一行最後的\為CommonMark換行語法):

![替代文字](網址)\
*圖片解說*

有關Twincl編輯器的補充說明

  1. 你不能在文字模式中修改編輯區以外的其他內容。

  2. 由於不同瀏覽器的HTML編輯模式存在許多差異,因此我們建議:新增段落或區塊最好在文字模式中進行,而僅將HTML模式用於文字的校對及小幅度修改。

  3. 當你在文字模式的最後插入兩行空白行並且切換模式時,前面的CommonMark文字會轉換成HTML,但你仍會留在文字模式中。

  4. 所有的Twincl網站都以https加密,因此你只能插入https圖片,不能插入http圖片。

其他說明

本文件只針對Twincl編輯器做說明。其他功能請參考「網站說明」文件。