Twincl編輯器
「Twincl編輯器」可編輯文章或討論的內容。它有兩種模式:
- 文字模式 - 編輯原始的CommonMark文字
- HTML模式 - 直接編輯內容本身
於編輯區內按快速鍵 ALT
+/
或 ⌘Command
+/
,可迅速在這兩種模式間切換。如要以文字模式編輯多個段落,請先反白選取段落即可。
CommonMark
Twincl編輯器採用CommonMark(一種Markdown語法)作為文件格式的語法。例如,上一節的原始CommonMark文字如下:
## Twincl編輯器
「Twincl編輯器」可編輯文章或討論的內容。它有兩種模式:
1. **文字模式** - 編輯原始的[CommonMark](http://commonmark.org)文字
1. **HTML模式** - 直接編輯內容本身
於編輯區內按快速鍵 `ALT`+`/` 或 `⌘Command`+`/` ,可迅速在這兩種模式間切換。
如要以**文字模式**編輯多個段落,請先反白選取段落即可。
以下是一些CommonMark的常用語法:
- 區塊語法
- 空白行:分隔段落或區塊
# 標題
、## 標題
……###### 標題
:標題1. 項目
、1) 項目
:有編號項目* 項目
、- 項目
、+ 項目
:無編號項目> 引言
:引言區塊```
:程式碼區塊的開始或結束
- 行內語法
[連結文字](連結網址)
: 連結![替代文字](圖片網址)
: 圖片*強調*
: 強調**強調**
: 強調`程式碼`
: 行內程式碼
關於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編輯器的補充說明
-
你不能在文字模式中修改編輯區以外的其他內容。
-
由於不同瀏覽器的HTML編輯模式存在許多差異,因此我們建議:新增段落或區塊最好在文字模式中進行,而僅將HTML模式用於文字的校對及小幅度修改。
-
當你在文字模式的最後插入兩行空白行並且切換模式時,前面的CommonMark文字會轉換成HTML,但你仍會留在文字模式中。
-
所有的Twincl網站都以https加密,因此你只能插入https圖片,不能插入http圖片。
其他說明
本文件只針對Twincl編輯器做說明。其他功能請參考「網站說明」文件。