標簽 · AsciiDoc簡明指南

## 標簽 ### [](https://github.com/stanzgy/wiki/blob/master/markup/asciidoc-guide.asciidoc#標題)標題需要靠左邊頂格 ~~~ = 文檔標題 (0級) = == 段落標題 (1級) == === 段落標題 (2級) === ==== 段落標題 (3級) ==== ===== 段落標題 (4級) ===== ~~~ ~~~ .段落，列表，表格或區塊標題 ~~~ ### [](https://github.com/stanzgy/wiki/blob/master/markup/asciidoc-guide.asciidoc#文字格式)文字格式下面的格式標簽前后要有空格，沒有空格的時候需要是雙符號。 _強調_?*強調* \'強調' '強調' *粗體*?**粗體** +等寬字體+ 等寬字體 `等寬字體`?`等寬字體`?里面的格式命令無效 \`單引號引用' `單引號引用' \``雙引號引用'' ``雙引號引用'' #無格式文本# 無格式文本里面的格式命令無效 [字體CSS顏色,背景CSS顏色,文字em大小] 使用在格式前面可以顯示顏色和大小可以使用[,,2]的形式 ^上標\^?上標 ~下標\~?下標 ### [](https://github.com/stanzgy/wiki/blob/master/markup/asciidoc-guide.asciidoc#特殊符號)特殊符號 (C) ? 版權 (TM) ? 商標 (R) ? 注冊商標 -- -- 破折號 ... …?省略號 -> → 右箭頭 <- ← 左箭頭 => ? 右雙箭頭 <= ? 左雙箭頭 ➊ ? ¶ ? ### [](https://github.com/stanzgy/wiki/blob/master/markup/asciidoc-guide.asciidoc#文本塊樣式)文本塊樣式 ~~~ //// CommentBlock（注釋塊）不輸出到目標文件 //// ~~~ ~~~ ++++ PassthroughBlock，不轉換內部的特殊字符 ++++ ~~~ ~~~ ---- ListingBlock（清單塊）用于計算機的輸出和文件列表。也可用于程序代碼。里面特殊字符不替換。 ---- ~~~ ~~~ .... LiteralBlock（文字塊）就像普通文字段落，保留了空格，使用[listing]塊標題可以在內部引用其他塊樣式。 .... ~~~ ~~~ **** SidebarBlock（側邊欄）有邊框和背景 **** ~~~ ~~~ ____ QuoteBlock（引用塊） ____ ~~~ ~~~ ==== ExampleBlock（例子塊）會使用數字編號的例子標題[caption="例1: "] 可以使用NOTE, TIP, IMPORTANT, WARNING, CAUTION標題[NOTE]表示提示塊 ==== ~~~ ~~~ -- OpenBlock（開放塊） -- ~~~ ### [](https://github.com/stanzgy/wiki/blob/master/markup/asciidoc-guide.asciidoc#提示段落)提示段落 'Tip’提示, 'Note’注意, 'Important’重要, 'Warning’警告和 'Caution’警示。例子： ~~~ NOTE: 這是一個注意的例子。 ~~~ 或使用替代語法: ~~~ [NOTE] 這是一個注意的例子。 ~~~ | 提示 | 如果警告多于一個段落使用警告段落替代. | #### [](https://github.com/stanzgy/wiki/blob/master/markup/asciidoc-guide.asciidoc#警告圖標和標題)警告圖標和標題 | 注意 | 警告可以定制?`icons`,?`iconsdir`,?`icon`?和?`caption`?參數。 | 默認生成文本標題替換圖標鏈接，生成圖標鏈接需要使用`-a icons`命令行參數。你可以使用`icon`參數制定圖標的路徑。例如： ~~~ [icon="./images/icons/wink.png"] NOTE: What lovely war. ~~~ 使用?`caption`?參數定義警告標題下例屏蔽圖標并定義了注釋警告的標題（在警告圖標設置為可用時`icons` 參數必須設置為`icons=None`）： ~~~ [icons=None, caption="特殊提示"] NOTE: This is my special note. ~~~ ### [](https://github.com/stanzgy/wiki/blob/master/markup/asciidoc-guide.asciidoc#列表)列表 #### [](https://github.com/stanzgy/wiki/blob/master/markup/asciidoc-guide.asciidoc#無序列表)無序列表 ~~~ - List item. * List item. ** List item. *** List item. **** List item. ***** List item. ~~~ #### [](https://github.com/stanzgy/wiki/blob/master/markup/asciidoc-guide.asciidoc#有序列表)有序列表手動序號序號使用下面一種 ~~~ 1\. 阿拉伯數字標注的列表項目. a. 小寫字母標注的列表項目. F. 大寫字母標注的列表項目. iii) 小寫羅馬數字標注的列表項目. IX) 大寫羅馬數字標注的列表項目. ~~~ 自動符號列表項目是1-5個句點，跟著是一些空格和文本。句點個數表示級別。例如： ~~~ . 阿拉伯數字標注的列表項目. .. 小寫字母標注的列表項目. ... 小寫羅馬數字標注的列表項目. .... 大寫字母標注的列表項目. ..... 大寫羅馬數字標注的列表項目. ~~~ #### [](https://github.com/stanzgy/wiki/blob/master/markup/asciidoc-guide.asciidoc#定義列表)定義列表字母或數字開始1-4個冒號或兩個分號結束。 ~~~ 項目1:: 項目2:: 項目說明. 項目說明. 項目3:: 項目說明. * 列表項. * 列表項. 項目4:: 說明1. 二級項目;; 二級說明. 二級項目;; 二級說明. 二級項目;; 二級說明. 三級項目::: 三級說明. 三級項目::: 三級說明. *水平項目*:: 水平說明. 水平說明. ~~~ #### [](https://github.com/stanzgy/wiki/blob/master/markup/asciidoc-guide.asciidoc#問答列表)問答列表 ~~~ [qanda] 問題1:: 答案1. 問題2:: 答案2. ~~~ #### [](https://github.com/stanzgy/wiki/blob/master/markup/asciidoc-guide.asciidoc#專業術語列表)專業術語列表 ~~~ [glossary] 術語1:: 解釋1. 術語2:: 解釋2. ~~~ ### [](https://github.com/stanzgy/wiki/blob/master/markup/asciidoc-guide.asciidoc#腳注)腳注 ~~~ A footnote footnote:[An example footnote.]; a second footnote with a reference ID footnoteref:[note2,Second footnote.]; finally a reference to the second footnote footnoteref:[note2]. ~~~ ### [](https://github.com/stanzgy/wiki/blob/master/markup/asciidoc-guide.asciidoc#超鏈接)超鏈接 'http'，'https'，'ftp'，'file'，'mailto’和’callto’超鏈接。直接書寫就行，參數是顯示名稱，空格使用%20。 ~~~ http://www.methods.co.nz/asciidoc/[The AsciiDoc home page] http://www.methods.co.nz/asciidoc/ mailto:joe.bloggs@foobar.com[email Joe Bloggs] joe.bloggs@foobar.com ~~~ ### [](https://github.com/stanzgy/wiki/blob/master/markup/asciidoc-guide.asciidoc#錨點)錨點 ~~~ 錨點：[[A88]] ~~~ ~~~ 鏈接：<<A88,chapter titles>> ~~~ ### [](https://github.com/stanzgy/wiki/blob/master/markup/asciidoc-guide.asciidoc#圖片)圖片 ~~~ image:images/logo.png["Company Logo",height=32,link="screen.png",scaledwidth="75%"align="left"] ~~~ ### [](https://github.com/stanzgy/wiki/blob/master/markup/asciidoc-guide.asciidoc#表格)表格 ~~~ [width="40%",cols="^,2m",frame="topbot",options="header,footer"] |====================== |Column 1 |Column 2 |1 |Item 1 |2 |Item 2 |3 |Item 3 |6 |Three items |====================== ~~~ ~~~ 表格參數： ~~~ ~~~ frame邊框topbot(上和下)，all(全部邊，默認), none and sides (左和右)。 align對齊left，right和center。 options選項header（有標題）footer（有底部） width寬度1-99% ~~~ ~~~ 行參數： ~~~ ~~~ [<multiplier>*][<align>][<width>][<style>] 左縮進，對齊，寬度，樣式 ~~~ ~~~ 單元格參數： ~~~ ~~~ [<span>*|+][<align>][<style>] *縮進，+合并 span語法[水平][.垂直]參數中<，^和>分別表示水平左中右和垂直上中下。 ~~~