MarkDown简明教程

简介

MarkDown是一种轻量级标记语法,这种语法利用特殊的文本字符来标识某种样式,让写作者在写作的时候可以全身心的关注内容,而不需要太关心文章格式。当写作完成后可以将MarkDown文件转换成HTML、PDF、图像、Epub等多种通用格式的文档。可以说MarkDown是写博客的利器。

比如说,MarkDown语法中使用两个**来标识加粗的样式。我们在书写时只需要写成

我是一段文本,这里需要**加粗**。

经过MarkDown渲染后就是下面的效果

我是一段文本,这里需要加粗

MarkDown由Aaron Swartz和John Gruber共同设计。Aaron Swartz就是那位在 2013年1月11日自杀,有着开挂一般人生经历的程序员。维基百科对他的介绍是:软件工程师、作家、政治组织者、互联网活动家、维基百科人。

他有着足以让你跪拜的人生经历:

  • 14岁参与RSS 1.0规格标准的制订。
  • 2004年入读斯坦福,之后退学。
  • 2005年创建Infogami,之后与Reddit合并成为其合伙人。
  • 2010年创立求进会(Demand Progress),积极参与禁止网络盗版法案(SOPA)活动,最终该提案被撤回。
  • 2011年7月19日,因被控从MIT和JSTOR下载480万篇学术论文并以免费形式上传于网络被捕。
  • 2013年1月自杀身亡。

优点
使用Markdown有很多优势。

  • Markdown这种标记语言可以非常方便的排版文章同事适配各大写作网站,这种沉浸式的写作体验让你专注于写作而不是纠结于排版(想想word的写作体验);
  • Markdown是纯文本的格式,比较轻量级,而且文本文件在各个平台(操作系统)上都能顺利打开;
  • 可以非常方便地转换成HTML、PDF、图像、Epub等多种通用格式;
  • 和HTML一样,Markdown也是一种标记语言,但是和HTML比起来,MarkDown更加易于书写,可读性也更高。

缺点

  • 由于MarkDown中的标记符号都是英文字符,所以如果你是用中文在写作的话需要经常切换输入法,比较麻烦。老外在设计MarkDown的时候只考虑到自己,有点“自私”,哈哈;
  • 支持的格式不够全,MarkDown支持的格式没有Word这种软件那么全。比如说原生MarkDown中的表格就不支持跨多行。

下面来介绍下MarkDown的简明用法。

MarkDown语法

MarkDown的语法非常简单,学习成本比较低。这也许也是MarkDown比较流行的一个原因。

标题语法

1、使用 = 和 – 标记一级和二级标题

我展示的是一级标题
=================

我展示的是二级标题
-----------------

但是这种格式的标题最多只能显示两级标题,平时我们用的比较多的还是下面介绍的#形式的标题。

2. 使用 # 号标记

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

段落字体语法

Markdown 段落没有特殊的格式,直接编写文字就好。段落的换行是使用两个以上空格加上回车。你也可以使用一个空行来表示开启一个新段落。

字体相关语法

*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___

显示效果如下:

斜体文本
斜体文本
粗体文本
粗体文本
粗斜体文本
粗斜体文本

分割线相关语法

***
* * *
*****
- - -
----------

效果如下:

删除线相关语法

如果段落上的文字要添加删除线,只需要在文字的两端加上两个波浪线 ~~ 。

~~程序员自由之路~~

显示效果如下:

程序员自由之路

下划线语法

<u>程序员自由之路</u>

显示效果如下:

程序员自由之路

标注语法

程序员自由之路[^slogan]

显示效果如下:

程序员自由之路[1]

列表语法

无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记

* 程序员自由之路1
+ 程序员自由之路2
- 程序员自由之路3

显示效果

  • 程序员自由之路1
  • 程序员自由之路2
  • 程序员自由之路3

有序列表使用数字并加上 . 号来表示。

1. 程序员自由之路1
2. 程序员自由之路2
3. 程序员自由之路3

显示效果如下

  1. 程序员自由之路1
  2. 程序员自由之路2
  3. 程序员自由之路3

有序列表和无序列表之间可以嵌套

1. 程序员1
    - 自由之路1
    - 自由之路2
2. 程序员2
	- 自由之路3
	- 自由之路4

显示效果如下:

  1. 程序员1
    • 自由之路1
    • 自由之路2
  2. 程序员2
  • 自由之路3
  • 自由之路4

引用语法

MarkDown中使用>来表示引用。

> 事实表明,执着的程序员更容易成功~

显示效果如下:

事实表明,执着的程序员更容易成功~

代码语法

MarkDown中一般使用一对“`来表示代码块。同时在“`旁边还可以指定代码具体是属于什么语言。

“`java
public class Hello{
public static void main(String[] args){
System.out.println(“Hello World…”);
}
}
“`

显示效果如下:

public class Hello{
    public static void main(String[] args){
        System.out.println("Hello World...");
    }
}

链接语法

MarkDown中链接的语法如下

[连接名称](链接地址)
<连接地址>

显示效果如下:

欢迎访问我的个人网站程序员自由之路

欢迎访问我的个人网站<www.chensongxia.cn>

MarkDown也支持文内跳转语法,一般通过HTML标签完成。

欢迎阅读自由之路写的代码

图片语法

MarkDown中的图片语法如下

![alt 属性文本](图片地址)

![alt 属性文本](图片地址 "可选标题")

我们可以使用img标签来使用更高级的图片样式。

<img src="line" width="50%" >

表格语法

MarkDown的表格语法如下:

|  表头   | 表头  |
|  ----  | ----  |
| 单元格  | 单元格 |
| 单元格  | 单元格 |

显示效果如下:

表头 表头
单元格 单元格
单元格 单元格

我们可以设置表格的对齐方式:

  • -: 设置内容和标题栏居右对齐。
  • :- 设置内容和标题栏居左对齐。
  • :-: 设置内容和标题栏居中对齐。
| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

显示效果如下:

左对齐 右对齐 居中对齐
单元格 单元格 单元格
单元格 单元格 单元格

HTML元素

目前MarkDown支持的HTML元素:<kbd> <b> <i> <em> <sup> <sub> <br>等。

参考

  1. 自由之路上我们携手前行 ↩︎

© 版权声明
THE END
喜欢就支持一下吧!
点赞0
分享