标题语法
H1
H2
H3
H4
H5
H6
区块引用 Blockquotes
这里是一个区块
blockquotes区块跳行 ...
class HelloWorld {
public static void main (String[] args){
System.out.println("");
}
} //只要再最后一行加上‘>’也行引用的嵌套
这是一个标题。
- 这是第一行列表项。
- 这是第二行列表项。
给出一些例子代码:
return shell_exec("echo $input | $markdown_script");
列表
Markdown 支持有序列表和无序列表。
无序列表使用星号、加号或是减号作为列表标记:
- Red
- Green
- Blue
等同于:
- Red
- Green
- Blue
也等同于:
- Red
- Green
- Blue
有序列表则使用数字接着一个英文句点:
- Bird
- McHale
- Parish
列表项目标记通常是放在最左边,但是其实也可以缩进,最多 3 个空格,项目标记后面则一定要接着至少一个空格或制表符。
要让列表看起来更漂亮,你可以把内容用固定的缩进整理好:
- Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
- Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.
如果要在列表项目内放进引用,那 >
就需要缩进:
- A list item with a blockquote: > This is a blockquote > inside a list item.
如果要放代码区块的话,该区块就需要缩进两次,也就是 8 个空格或是 2 个制表符:
- 一列表项包含一个列表区块: <代码写在这>
当然,项目列表很可能会不小心产生,像是下面这样的写法:
- What a great season.
换句话说,也就是在行首出现数字-句点-空白,要避免这样的状况,你可以在句点前面加上反斜杠。
1986. What a great season.
代码区块
<pre><code>NSLog("%@",NSString stringWithFormat:@"HelloWorld")</code></pre>
分割线
你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:
区段元素
链接
Markdown 支持两种形式的链接语法: 行内式 和 参考式 两种形式。
不管是哪一种,链接文字都是用 [方括号] 来标记。
要建立一个行内式的链接,只要在方块括号后面紧接着圆括号并插入网址链接即可,如果你还想要加上链接的 title 文字,只要在网址后面,用双引号把 title 文字包起来即可,例如:
<blockquote>
This is an example inline link.This link has no title attribute.
</blockquote>
会产生:
<blockquote>
<p>This is <a href="http://example.com/" title="Title">
an example</a> inline link.</p>
<p><a href="http://example.net/">This link</a> has no
title attribute.</p>
</blockquote>
如果你是要链接到同样主机的资源,你可以使用相对路径:
<blockquote>
See my About page for details.
</blockquote>
参考式的链接是在链接文字的括号后面再接上另一个方括号,而在第二个方括号里面要填入用以辨识链接的标记:
<blockquote>
This is [an example][id] reference-style link.
</blockquote>
你也可以选择性地在两个方括号中间加上一个空格:
<blockquote>
This is [an example] [id] reference-style link.
</blockquote>
接着,在文件的任意处,你可以把这个标记的链接内容定义出来:
<blockquote>
[id]: http://example.com/ "Optional Title Here"
</blockquote>
强调
Markdown 使用星号()和底线()作为标记强调字词的符号,被 *或 _ 包围的字词会被转成用 <em>标签包围,用两个 *或包起来的话,则会被转成 <strong>,例如:
single asteriskssingle underscoresdouble asterisks*double underscores
会转成:
<em>single asterisks</em><em>single underscores</em><strong>double asterisks</strong><strong>double underscores</strong>
你可以随便用你喜欢的样式,唯一的限制是,你用什么符号开启标签,就要用什么符号结束。
强调也可以直接插在文字中间:
unfriggingbelievable
但是*如果你的 和 _两边都有空白的话,它们就只会被当成普通的符号。
如果要在文字前后直接插入普通的星号或底线,你可以用反斜线:
*this text is surrounded by literal asterisks*
代码
如果要标记一小段行内代码,你可以用反引号把它包起来(`),例如:
Use the printf()
function.
图片
很明显地,要在纯文字应用中设计一个「自然」的语法来插入图片是有一定难度的。
Markdown 使用一种和链接很相似的语法来标记图片,同样也允许两种样式: 行内式和参考式。
行内式的图片语法看起来像是:
详细叙述如下:
一个惊叹号 !
接着一个方括号,里面放上图片的替代文字
接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上 选择性的 'title' 文字。
参考式的图片语法则长得像这样:
![Alt text][id]
「id」是图片参考的名称,图片参考的定义方式则和连结参考一样:
[id]: url/to/image "Optional title attribute"
到目前为止, Markdown 还没有办法指定图片的宽高,如果你需要的话,你可以使用普通的 <img>
标签。
如果实在看晕了 : 看一下wiki上的这个对比图就知道了
(https://en.wikipedia.org/wiki/Markdown#Example)
给个github follow me的链接,上面有很多初学者可供学习的资料,项目.
<a>https://github.com/SuperZee</a>