Markdown的简单用法

最新推荐文章于 2025-04-26 16:16:34 发布

转载最新推荐文章于 2025-04-26 16:16:34 发布 · 726 阅读

本文介绍Markdown的基本语法及其应用场景，帮助读者快速掌握这一轻量级标记语言。内容涵盖标题、列表、链接、图片等常用元素的使用方法。

部署运行你感兴趣的模型镜像

Markdown 是一种用来写作的轻量级标记语言，它用简洁的语法代替排版，而不像一般我们用的字处理软件 Word 或 Pages 有大量的排版、字体设置。它使我们专心于码字，用「标记」语法，来代替常见的排版格式。例如此文从内容到格式，甚至插图，键盘就可以通通搞定了。目前来看，支持 Markdown 语法的编辑器有很多，包括很多网站（例如简书）也支持了 Markdown 的文字录入。Markdown 从写作到完成，导出格式随心所欲，你可以导出 HTML 格式的文件用来网站发布，也可以十分方便的导出 PDF 格式，这种格式写出的简历更能得到 HR 的好感。甚至可以利用 CloudApp 这种云服务工具直接上传至网页用来分享你的文章，全球最大的轻博客平台 Tumblr，也支持 Mou 这类 Markdown 工具的直接上传。

二八定律说：
百分之二十的知识解决百分之八十的问题。
如果你想学习和使用Markdown，我建议：
__常用标记__要先花一些时间熟记，后面经常使用的话就会形成习惯了，不过脑的正常书写，跟打字一样；
__次常用标记__要有基本的印象，能记住也是可以的；
__不常用标记__和专用标记just看看就好，等到使用的时候百度一下，你就知道。

简介:

markdown是html的一个子集，它通过在文本中插入标示符的方式来构造文章排版。
markdown源文件以.md为后缀名的纯文本格式保存。

正文

段落：前后为空行
换行：行末双空格
区块：行前四空格
引用：行前加>号

常用标记

标题

使用#表示标题，一级标题使用一个#，二级标题使用两个##，以此类推，共有六级标题。
使用=====表示高阶标题，使用---------表示次阶标题。
#和标题之间最好加一个空格。====和----表示标题时，大于等于2个都可以表示。

示例:

代码：
# 你好
```
你好
===
```

效果：

你好

引用

使用>表示引用，>>表示引用里面再套一层引用，依次类推。

示例
例1：
代码：

> 这是一级引用
>>这是二级引用
>>> 这是三级引用

>这是一级引用

效果：

这是一级引用

这是二级引用

这是三级引用

这是一级引用

注意
如果>和>>嵌套使用的话，从>>退到>时，必须之间要加一个空格或者>作为过渡，否则默认为下一行和上一行是同一级别的引用。如示例所示。
引用标记里可以使用其他标记，如：有序列表或无序列表标记，代码标记等。

代码块

使用``` 表示代码块。

示例:

```
a=range(10)
for i in a:
print(i)
```

效果：

a=range(10)       
for i in a:       
    print(i)

注意
`这个符号是在Esc键下面，切换到英文下即可。
```后面的javascript表示此段代码为python代码，Markdown会自行使用python代码颜色渲染。这里也可以不写。

行内代码

使用 ` 表示行内代码。

示例:

    这是`javascript`代码

这是javascript代码

列表

使用1. 2. 3.表示有序列表，使用*或-或+表示无序列表。

例1：有序列表

1. 第一点
2. 第二点
4. 第三点

效果：

第一点
第二点
第三点

例2：无序列表

+ 呵呵
    * 嘉嘉
    - 嘻嘻
    - 吼吼
        - 嘎嘎
        + 桀桀
* 哈哈

效果：

呵呵
- 嘉嘉
- 嘻嘻
- 吼吼
  - 嘎嘎
  - 桀桀
哈哈

注意:

无序列表或有序列表标记和后面的文字之间要有一个空格隔开。
有序列表标记不是按照你写的数字进行显示的，而是根据当前有序列表标记所在位置显示的，如示例1所示。
无序列表的项目符号是按照实心圆、空心圆、实心方格的层级关系递进的，如例2所示。通常情况下，同一层级使用同一种标记表示，便于自己查看和管理。
无序列表和有序列表标记的使用场景也很明了，故不多说。

粗体和斜体

使用** 或者 __ (双下划线)表示粗体。

使用 *或者 _ 表示斜体。

示例

**粗体1**    __粗体2__
*斜体1*    _斜体2_

粗体1 粗体2
斜体1 斜体2

注意：
前后的*或_与要加粗或倾斜的字体之间不能有空格。

表格(`-`的个数可以为任意大于1的数)

------:为右对齐。
:------为左对齐。
:------:为居中对齐。

示例

|序号|交易名|交易说明|备注|
|------: |:-------:|:---------|------|
|1|prfcfg|菜单配置|可以通过此交易查询到所有交易码和菜单的对应关系|
|2|gentmo|编译所有交易||
|100000|sysdba|数据库表模型汇总||

效果：

序号	交易名	交易说明	备注
1	prfcfg	菜单配置	可以通过此交易查询到所有交易码和菜单的对应关系
2	gentmo	编译所有交易
100000	sysdba	数据库表模型汇总

分割线

使用---或者***或者* * *表示水平分割线。

示例

---

***

* * *

注意
只要*或者-大于等于三个就可组成一条平行线。
使用---作为水平分割线时，要在它的前后都空一行，防止---被当成标题标记的表示方式。

链接

使用[](link "Optional title")表示行内链接。其中：
[]内的内容为要添加链接的文字。
link为链接地址。
Optional title为显示标题。显示效果为在你将鼠标放到链接上后，会显示一个小框提示，提示的内容就是 Optional title里的内容。
参考式链接如例所示。

示例

例1：行内链接

这就是我们常用的地址：[简书](http://www.jianshu.com "简书")

这就是我们常用的地址：简书

例2：参考式链接

这就是我们常用的地址：[Baidu][1]

[1]:www.baidu.com "百度一下，你就知道"

这就是我们常用的地址：
Baidu

注意

参考式链接和行内链接的显示效果是一样的，但是在编辑状态下的使用情况不一样。行内连接紧跟链接文字，可以在看到链接文字的同时清楚的知道链接地址，但是不便于多次重复利用。参考式链接可以重复使用，但一般都是将一些链接放在一起统一管理，如一段文字后面或文章结尾，因此在找到链接和链接文字的对应关系上有些麻烦。各有利弊了，分情况使用。

导入图片

使用![Alt text](/path/to/img.jpg "Optional title")导入图片。其中：
1. Alt text为如果图片无法显示时显示的文字；
2. /path/to/img.jpg为图片所在路径；
3. Optional title为显示标题。显示效果为在你将鼠标放到图片上后，会显示一个小框提示，提示的内容就是 Optional title里的内容。

示例

![Markdown](http://images.cnitblog.com/blog/404392/201501/122257231047591.jpg)

Markdown

注意

导入的图片路径可以使用绝对路径也可以使用相对路径，建议使用相对路径。

Markdown文档的同级目录下建立一个pictures文件夹，里面放置所有所需的图片，如果图片多的话，你也可以在pictures文件夹里建立子文件夹归类。
最好的做法是使用网址，还有博客园以及简书可以直接拖曳或上传图片。

反斜杠

使用\表示反斜杠。在你不想显示Markdown标记时可以使用反斜杠。

示例
\*这里不会显示斜体\*

*这里不会显示斜体*

空格

Markdown语法会忽略首行开头的空格，如果要体现出首行开头空两个的效果，可以使用全角符号下的空格，windows下使用shift+空格切换。

次常用标记

标签分类

使用 标签: 或者 Tags: 表示标签标记。
示例

标签: 数学 英语
Tags: 数学 英语

标签: 数学英语
Tags: 数学英语

注意

标签:或者Tags:的冒号要使用半角冒号。
基本没使用过这个标记，不过应用场景应该是归类。便于快速了解文章分类。

删除线

说明

使用~~表示删除线。

示例

~~这是一条删除线~~

~~这是一条删除线~~

注意

注意~~ 和要添加删除线的文字之间不能有空格

不常用标记

邮件:<example@example.com> 引用存储文件 [example](…/…/example.md)
```
  <example@example.com>  引用存储文件  [example](…/…/example.md)
```
转义符：\

实现页内跳转

使用html代码实现页内跳转。在要跳转到的位置定义个锚<span id = "jump">hehe</span>，然后使用[你好](#jump)将你好设置为一单击即跳转到hehe所在位置的效果。

示例

[你好](#jump)
<span id = "jump">hehe</span>

你好
hehe

专项使用标记

流程图

以后在总结吧，现在的我完全没有使用上，没有需求就先不总结了。

LaTeX公式

Cmd Markdown 公式指导手册

公式

行内公式：$
整行公式：$$
显示链接中带括号的图片

![][1]      
[1]: http://latex.codecogs.com/gif.latex?\prod%20\(n_{i}\)+1

1: http://latex.codecogs.com/gif.latex?\prod%20$n_{i}$+1

轻量级标记语言（lightweight markup language），是一类用简单句法描述简单格式的文本语言。最早出现在无法呈现斜体和粗体文本的只能显示文本的显示器，所以必须开发非常规的方法来表达这些信息，这些格式自然被带入了通常使用文本的电邮通信中。作为一种标记语言，它的语法简单，可方便地使用简单的文本编辑器输入，源文件容易阅读和编辑，原生格式接近自然语言，纯文本有跨平台特性。所谓“轻量级”是相对于其他更丰富格式的标记语言而言的（如富文本格式语言RTF、超文本标记语言HTML、学术界排版语言TeX等）。

您可能感兴趣的与本文相关的镜像