初学markdown
分段与标题
-
分段
正如markdown文档所说的,段落是由若干行组成的,段落之间以一行空行分开。(也就是每一段的前后都要有一个空行)
>一个 Markdown段落是由一个或多个连续的文本行组成,它的前后要有一个以上的空行(空行的定义是显示上看起来像是空的,便会被视为空行。比方说,若某一行只包含空格和制表符,则该行也会被视为空行)。
>[Markdown语法说明](http://wowubuntu.com/markdown/#p)
-
标题
学习markdown最先接触的自然是标题了,#号的多少直接代表标题的级数,级数越大,标题越小。(比如#####title代表5级标题,不过实际最多用到4级吧-,-) 以下为一些标题的实例。
#一级
##二级
###三级
####四级
# 一级
## 二级
### 三级
#### 四级
区块引用
使用一个>符号来表示引用,其后的内容会以引用形式出现。重复使用>即可实现多重区块。(比如>>>会出现3级区块)
>这是一个区块实例
>>>这是一个三级区块,在区块内部,所有语法也均可使用
这是一个区块实例
这是一个三级区块,在区块内部,所有语法也均可使用
有序和无序列表
无序列表使用 (*
),(-
) 或者(+
)来使用,有序列表则直接使用数字加点的形式。需要注意的是,在符号和列表内容之间需要一个空格去分开。
-错误使用
- 正确使用
-错误使用
- 正确使用
其次,列表可以使用空格进行缩进嵌套,最多3层。一个列表下可以有多个段落,只要有同样的缩进即可(即4个空格或者一个Tab),若是不愿每行缩进,则至少保证每段段首有缩进)
>- a
> 这是第一段
> 这是第二段
> - b
> - c
- a
这是第一段
这是第二段
- b
- c
最后需要注意的是,在列表内使用代码区块需要缩进8个空格或者2个Tab,而不是4个空格。
代码区块
代码区块的作用显而易见,保持原本的代码格式便于查阅,浏览。同时,在代码区块中markdown语法不会生效,可以用来编写介绍markdown相关语法的内容。
区块引用采用>符号来标明,而代码区块的使用更加明了,直接一个Tab缩进即可。
这是一个段首:
这是一个代码区块
分割线
熟悉的分割线的使用方法也很简单,3个星号,减号均可。
***
* * *
---
链接
-
介绍
虽说说明文档里将链接归为区段元素,之上介绍的分割线区块引用等分为区块元素。不过个人比较懒,也就不细分了。
链接分为两种方式,行内式和参考式。两种方法有共同指出也有不同之处。共同之处为链接文字均用中括号表示
不同之处即为链接的位置。顾名思义,行内式即为在行内直接插入链接。而参考式则指定一个id,后续对id进行定义。
-
格式
行内式 [链接文字](链接地址 "title") 参考式 [链接文字][id] 参考式定义 [id]: 链接地址 "title"或‘title’或(title)
-
结论
显而易见,行内式明显没有参考式功能强大,不过胜在简单。而参考式正确的使用方法自然是在文中标记,在文末或者某一个固定的地方进行集中定义,这样统一管理自然省心。其次,在文章中频繁出现冗长的链接着实令人不开心,阅读修改体验太差,而这也是选择参考式的原因之一。
Tips:若要链接到本地资源,使用相对地址即可。
强调
使用星号(*
)和下划线(_
)可以对内容进行强调,最多可使用强调两次,即(**
)或(__
)。
需要强调的是,两个强调符号的两边不能都为空格,否则无效。
*s*
代码
使用两个反引号(`
)可以将一段代码标记出来,所以若要在代码区段内插入反引号,则需要多个反引号来解决。
这是printf('hello world');
同时,若要在代码的一开始使用反引号,则需要在被标记内容前后添加一个空格。
`前后添加空格可以显示出前后的两个反引号`
图片
图片的使用和链接类似,不做过多介绍,唯一的区别,即为在链接地址前增加一个感叹号。即
![链接文字](链接地址 "title")
目前markdown无法对图片进行进一步调整,不过可以通过img标签来进行。
图片本打算直接本地上传,尝试多次不成,后来发现简书可以上传到服务器上,再加上本地上传也有不便之处。
图片上传就先这样做吧。
遇到的问题
- 在简书中正常,到博客园就有了一些问题,查证才发现,是因为简书对一些内容的规范降低了,虽然好写,不过兼容性不好。
- 任何区块,还是要前后都留空行。
- 代码确实是一个Tab的事,不过需要前后留空。
- 注意空格数量,尽量使用Tab。
- 列表的3级缩进无法实现。
- (已解决)若用单行代码表示(
`
)时,在一段内若还有单行代码表示,会导致反引号匹配错误。
参考内容