初学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个星号,减号均可。

***
* * *
---

链接

  1. 介绍

虽说说明文档里将链接归为区段元素,之上介绍的分割线区块引用等分为区块元素。不过个人比较懒,也就不细分了。
链接分为两种方式,行内式和参考式。两种方法有共同指出也有不同之处。共同之处为链接文字均用中括号表示
不同之处即为链接的位置。顾名思义,行内式即为在行内直接插入链接。而参考式则指定一个id,后续对id进行定义。

  1. 格式

     行内式    [链接文字](链接地址 "title")
     参考式    [链接文字][id]
     参考式定义 [id]: 链接地址 "title"或‘title’或(title)
    
  2. 结论

    显而易见,行内式明显没有参考式功能强大,不过胜在简单。而参考式正确的使用方法自然是在文中标记,在文末或者某一个固定的地方进行集中定义,这样统一管理自然省心。其次,在文章中频繁出现冗长的链接着实令人不开心,阅读修改体验太差,而这也是选择参考式的原因之一。

Tips:若要链接到本地资源,使用相对地址即可。

强调

使用星号(*)和下划线(_)可以对内容进行强调,最多可使用强调两次,即(**)或(__)。
需要强调的是,两个强调符号的两边不能都为空格,否则无效。

*s* 

代码

使用两个反引号(`)可以将一段代码标记出来,所以若要在代码区段内插入反引号,则需要多个反引号来解决。
这是printf('hello world');
同时,若要在代码的一开始使用反引号,则需要在被标记内容前后添加一个空格。
`前后添加空格可以显示出前后的两个反引号`

图片

图片的使用和链接类似,不做过多介绍,唯一的区别,即为在链接地址前增加一个感叹号。即

![链接文字](链接地址 "title")

目前markdown无法对图片进行进一步调整,不过可以通过img标签来进行。
图片本打算直接本地上传,尝试多次不成,后来发现简书可以上传到服务器上,再加上本地上传也有不便之处。
图片上传就先这样做吧。

遇到的问题

  • 在简书中正常,到博客园就有了一些问题,查证才发现,是因为简书对一些内容的规范降低了,虽然好写,不过兼容性不好。
  • 任何区块,还是要前后都留空行。
  • 代码确实是一个Tab的事,不过需要前后留空。
  • 注意空格数量,尽量使用Tab。
  • 列表的3级缩进无法实现。
  • (已解决)若用单行代码表示(`)时,在一段内若还有单行代码表示,会导致反引号匹配错误。

参考内容

  1. Markdown语法说明(简体中文版)


posted @ 2016-08-30 21:09  ysrcyx  阅读(174)  评论(1编辑  收藏  举报