目錄
0、概述
此文檔爲了指導在wordpress下使用Markdown on Save插件編寫markdown。
markdown語法說明請參閱:http://wowubuntu.com/markdown/index.html
1、段落
1.1、段落標題
根據原文中的文檔標題可以對應設置標題。
# 一級標題
## 二級標題
### 三級標題
效果 =>
一級標題
二級標題
三級標題
1.2、加粗、斜體
*單星號* => 單星號
_單下劃線_ => 單下劃線
**雙星號** => 雙星號
__雙下劃線__ => 雙下劃線
1.3、列表
1.3.1 無序列表示例:
* item1
* item2
* item3
效果 =>
- item1
- item2
- item3
1.3.2 有序列表示例:
1. item1
1. item2
1. item3
效果 =>
- item1
- item2
- item3
注意:列表要與上面的內容有換行。
1.3.3 多級列表示例
注意:第二行+前應該有空格。
* item1
+ item1.1
* item2
+ item2.1
效果 =>
- item1
- item1.1
- item1.2
- item2
- item2.1
- item2.2
注意:多級列表只支持2層。
1.3.4 列表項目有多個段落
注意:正文前有四個空格或製表符
* 第一段
正文
* 第二段
效果 =>
- 第一段
正文
-
第二段
1.4、區塊引用
1.4.1 普通區塊
與標準的markdown語法一致:
> 這是一段文字
> 第二行
> 第三行
效果 =>
這是一段文字
第二行
第三行
1.4.2 嵌套區塊
> 第一層
>> 嵌套第二層
> 還是第一層
效果 =>
第一層
嵌套第二層
還是第一層
1.5、鏈接、圖片
注意:鏈接中如果帶有特殊符號,比如 & 需要用轉義字符進行標示 \&
。
1.5.1 鏈接
與markdown標準語法兼容。示例:
This is [an example](http://example.com/ “Title”) inline link.
[This link](http://example.net/) has no title attribute.
效果 =>
This is an example inline link.
This link has no title attribute.
1.5.2 圖片
圖片示例:
![Importnew](http://www.importnew.com/wp-content/uploads/2012/11/importNew-233×50.jpg)
效果 =>
建議:翻譯時,可以直接引用原文鏈接。在提交到Importnew時,可以通過 上傳或插入 功能將圖片上傳並插入到文章。
2、代碼
2.1、關鍵詞
可以通過“標記需要突出的關鍵詞或變量,例如
`public` =>
public
`main(String[] args)` =>main(String[] args)
2.2、代碼段
這裏與普通markdown語法有些區別。Java代碼示例:
<pre class=”brush: java; gutter: true;”>
// Java代碼
class HelloImportnew {}
</pre>
效果 =>
// Java代碼
class HelloImportnew {
}
類似的,通過將brush參數進行替換可以支持其他語言。
支持的常用語言包括java, xml, shell, html, diff。例如替換爲xml:
<pre class=”brush: xml; gutter: true;”>
(其他支持的語言有:actionscript3
, applescript
, bash
, c
, csharp
, cpp
, css
, coldfusion
, delphi
, diff
, erlang
, groovy
, html
, javafx
, javascript
, php
, pascal
, patch
, perl
, text
, powershell
, python
, ruby
, rails
, sql
, sass
, scala
, shell
, vb
, vbnet
, xhtml
, xml
, xslt
)。
推薦開啓顯示行號。如果不需要顯示行號,可以設置 gutter: false
。
3、表格等複雜情況
markdown的主要設計目標是簡潔,通過支持html代碼實現對各種複雜情況的處理。
如果需要加入表格等複雜的界面,可以直接嵌入html代碼。
表格示例:
<table border=”1″>
<tr>
<td>row 1, cell 1</td>
<td>row 1, cell 2</td>
</tr>
<tr>
<td>row 2, cell 1</td>
<td>row 2, cell 2</td>
</tr>
</table>
效果 =>
row 1, cell 1 | row 1, cell 2 |
row 2, cell 1 | row 2, cell 2 |
建議:對於文章中的複雜內容,可以直接查看頁面源代碼,copy需要翻譯的部分。
<!-- BEGIN #author-bio -->