Markdown语法样例

手记
编程

　　MarkDown是轻量级的标记语言，它的语法类似Html的简化版，比Html更方便记忆。自从年初用markdown搭建了小组内部文档系统网站后，就迷上了它。

　　一个文档的元素无非是标题、段落、链接、样式等，在office word里这些是通过一些操作来标记的，标记完后word会直接显示，但只有装了相关软件才能查看和编辑word，想象下office的笨重还有linux、windows、mac系统跨平台编辑、word与其他格式文件转换的问题，总让人痛苦不堪。此外，word各种样式繁琐，编辑不当容易丢失、存储还有文档格式损坏问题，因此，Markdown无疑是来拯救我们的。

　　Markdown相比Html学习成本低，且排版格式好、可读性强。它是纯文本格式，可跨操作系统跨软件平台共享。通过一些标记来定义段落、表格、图片、链接、样式等，文档保存后缀为md，文档可转换为pdf、html等多种格式，码字的人类因此可专注写作。

　　夙夜札记所用的Hexo文档就是Markdown，那么开篇总结下Markdown的通常用法。

1. Markdown语法导图

Markdown语法图

2. Markdown样例对照效果

2.1 标题

# 这是一级标题的效果

这是一级标题的效果

## 这是二级标题的效果

这是二级标题的效果

### 这是三级标题的效果

这是三级标题的效果

#### 这是四级标题的效果

这是四级标题的效果

##### 这是五级标题的效果
这是五级标题的效果
###### 这是六级标题的效果
这是六级标题的效果

2.2 分割线

***

2.3 段落

段落：段落间空行或者两个空格回车强制换行

2.4 区块

>区块测试：在段落前加\>符号

区块测试：在段落前加>符号

2.5 列表

+ 无序列表符号加号  
- 无序列表符号减号
* 无序列表符号星号    
1.  有序列表符号,数字加英文句号
2.  序号与文字间有至少一个空格
4.  即使这行标号错误，最终显示会是正确的
  • 无序列表符号加号
  • 无序列表符号减号
  • 无序列表符号星号
  1. 有序列表符号,数字加英文句号
  2. 序号与文字间有至少一个空格
  3. 即使这行标号错误，最终显示会是正确的

2.6 文字样式

*斜体是一个成对星号*

斜体是一个成对星号

**粗体是两个成对星号**

粗体是两个成对星号

2.7 表格

| 默认文字居左  |*文字居中*     | **文字居右** |
| ------------- |:-------------:| ------------:|
| 无冒号        | 一对冒号      | 冒号居右     |
默认文字居左 文字居中 文字居右
无冒号 一对冒号 冒号居右

2.8 链接

[行内链接样例：夙夜札记链接](xinduihong.cn)

行内链接样例：夙夜札记链接

[本文学习参考链接][1]

本文学习参考链接

[1]:  http://wowubuntu.com/markdown/#philosophy   "Markdown 语法说明 (简体中文版)"

3. 结束语

　　对比原文和效果，可以看出Markdown不同标记在网页的展示。使用Markdown要注意符号之后的空格，缺少空格时语法会失效。

　　本文样例中缺少自动链接、隐式链接，再补充说明下：

　　隐式链接可以省略链接地址，在其他地方对链接内容进行补充。当文档涉及链接太多时，使用隐式链接，在段末时对缺省的各链接地址进行统一定义，修改时比较方便。

　　自动链接用于不需要额外名称的链接，支持以比较简短的自动链接形式来处理网址和电子邮件信箱，只要是用尖括号包起来，Markdown就会自动把它转成链接。

　　Markdown编辑时需要看实时显示效果的话需要使用编辑工具预览，现在印象笔记、有道云笔记、Tower也开始支持Markdown，而其他好用的markdownd编辑器也很多，降低了编辑和阅读共享的门槛。
　　
声明：原创文章在公众号“夙夜札记”同步，微信ID为RheaTime，如需转载请联系本人！

评论