Markdown基础语法详细版

简介: Markdown基础语法详细版

1 Markdown简介

       百度百科释义:Markdown是一种轻量级标记语言,创始人为约翰·格鲁伯(英语:John Gruber)。它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。

       由于Markdown的轻量化、易读易写特性,并且对于图片、图表、数学式都有支持,被网站广泛使用来撰写帮助文档或是用于论坛上发表消息。

2 Markdown特点

       通过简介部分相信大家应该对Markdown有了初步了解,综合来看,可以用以下四点来大致概括这一被广泛使用的语言。

  • 一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。
  • 于 2004 由约翰·格鲁伯(英语:John Gruber)创建。
  • 编写的文档可导出 HTML 、Word、图像、PDF、Epub 等多种格式。
  • 编写的文档后缀为 .md, .markdown。

3 Markdown基本语法

3.1 标题

       随着“#”号个数增加,标题级别逐级下降。其中,“#”与文字间存在一个空格。

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

3.2 斜体和粗体

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

       显示效果:

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

3.3 换行

  • 一句话后面敲两个空格。
  • 两句话之间加一个空行。
  • 语言分行位置输入代码<br/>

3.4 分割线

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

       显示效果:




3.5 列表

3.5.1 无序列表

       利用使用 *,+,- 表示无序列表。

* 无序列表项 一
+ 无序列表项 二
- 无序列表项 三

       显示效果:

  • 无序列表项 一
  • 无序列表项 二
  • 无序列表项 三

3.5.2 有序列表

       利用数字后加一个英文句点。

1. 有序列表项 一
2. 有序列表项 二
3. 有序列表项 三

显示效果:

  1. 有序列表项 一
  2. 有序列表项 二
  3. 有序列表项 三

3.5.3 定义型列表

       由名词和解释组成。一行写定义,接着一行写解释。解释语句写法:紧跟一个缩进(Tab)。

Markdown
  一种轻量级标记语言
代码块 2
  代码块2的定义说明

       显示效果:

       Markdown

               一种轻量级标记语言

       代码块 2

               代码块2的定义说明

3.5.4 列表缩进

       项目标记后面则一定要接着至少一个空格或制表符。

*   Markdown是一种轻量级标记语言,创始人为[约翰·格鲁伯](英语:John Gruber)。它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。 
*   由于Markdown的轻量化、易读易写特性,并且对于图片、图表、数学式都有支持,被网站广泛使用来撰写帮助文档或是用于论坛上发表消息。

       显示效果:

  • Markdown是一种轻量级标记语言,创始人为[约翰·格鲁伯](英语:John Gruber)。它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。
  • 由于Markdown的轻量化、易读易写特性,并且对于图片、图表、数学式都有支持,被网站广泛使用来撰写帮助文档或是用于论坛上发表消息。

3.5.5 包含段落的列表

       每个项目下的段落都必须缩进 4 个空格或是 1 个制表符。

*   Markdown是一种轻量级标记语言,创始人为[约翰·格鲁伯](英语:John Gruber)。它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。 
    由于Markdown的轻量化、易读易写特性,并且对于图片、图表、数学式都有支持,被网站广泛使用来撰写帮助文档或是用于论坛上发表消息。

       显示效果:

  • Markdown是一种轻量级标记语言,创始人为[约翰·格鲁伯](英语:John Gruber)。它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。
    由于Markdown的轻量化、易读易写特性,并且对于图片、图表、数学式都有支持,被网站广泛使用来撰写帮助文档或是用于论坛上发表消息。

3.5.6 包含引用的列表

       “>”符号前就需要加缩进。

*   一天是什么:
    > 睁眼。
    > 闭眼。

       显示效果:

  • 一天是什么:

睁眼。

闭眼。

3.5.7 包含代码区块的引用

       将代码块放入<>

`<这是一个代码块>`

显示效果:

<这是一个代码块>

4 Markdown进阶

4.1 锚点操作

       锚点含义:页内添加超链接,即链接本文档内部的某部分元素,实现当前页面中的跳转。

跳转到[Markdown简介](#index)

       显示效果:

       跳转到Markdown简介

4.2 插入代码

4.2.1 插入行内式

`abs()` 函数使用方法

       显示效果:

 abs() 函数使用方法

4.2.2 缩进式多行代码

       缩进 4 个空格或是 1 个制表符。

#include <stdio.h>
    int main(void)
    {
        printf("Hello world\n");
    }

       显示效果:

#include <stdio.h>
int main(void)
{
    printf("Hello world\n");
}

4.2.3 用六个`包裹多行代码

       在插入代码开始和结尾行分别加三个`符号。

```
#include <stdio.h>
int main(void)
{
    printf("Hello world\n");
}
、、、

       显示效果:

#include <stdio.h>
int main(void)
{
    printf("Hello world\n");
}
、、、

4.2.4 HTML 原始码

       代码区内, & 、 < 和 > 会自动转成 HTML 实体。

<div class="footer">
   © 2004 Foo Corporation
</div>
<table>
    <tr>
        <th rowspan="2">销售冠军</th>
        <th>星期一</th>
        <th>星期二</th>
        <th>星期三</th>
    </tr>
    <tr>
        <td>张三</td>
        <td>李四</td>
        <td>王五</td>
    </tr>
</table>

       显示效果:

© 2004 Foo Corporation

值班人员 星期一 星期二 星期三
李强 张明 王平

4.3 插入链接

[百度](https://www.baidu.com)
<https://www.baidu.com>

       显示效果:

 百度

       或

 https://www.baidu.com

4.4 插入图片

<div align="center">
<img src="https://ucc.alicdn.com/images/user-upload-01/img_convert/af74d45eef8f36b4194bf25524f608f4.png" width="20%" >
</div>

       显示效果:

4.5 插入表格

       示例:3行4列表格(含表头)。

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

       显示效果:

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

4.6 添加脚注

       脚注具体内容自动移动到文章末尾。同时脚注后方的链接可以直接跳转回到加注的地方。

使用 Markdown[^1]可以效率的书写文档, 直接转换成 HTML[^2], 你可以使用 Leanote[^Le] 编辑器进行书写。
[^1]:Markdown是一种纯文本标记语言
[^2]:HyperText Markup Language 超文本标记语言
[^3]:开源笔记平台,支持Markdown和笔记直接发为博文

       显示效果:

       使用 Markdown1可以效率的书写文档, 直接转换成 HTML2, 你可以使用 Leanote3 编辑器进行书写。

4.7 LaTeX 公式

4.7.1 行内公式

正方形面积公式: $S=L^2$。

       显示效果:

       正方形面积公式: S = L 2 S=L^2S=L2

4.7.2 整行公式

       更多公式可参考:LaTeX 公式

$$
正方形面积公式:S=L^2
$$

       显示效果:

正方形面积公式 : S = L 2 正方形面积公式:S=L^2正方形面积公式:S=L2

参考文献


  1. Markdown是一种纯文本标记语言。 ↩︎
  2. HyperText Markup Language 超文本标记语言。 ↩︎
  3. 开源笔记平台,支持Markdown和笔记直接发为博文。 ↩︎
相关文章
|
1月前
markdown常用语法--花括号(超详细)
markdown常用语法--花括号(超详细)
|
8月前
|
程序员 Windows
markdown的基本语法
markdown的基本语法
69 0
|
8天前
markdown语法
学习Markdown基本语法:标题、段落、强调、列表、代码块等,轻松撰写整洁文档。[查看教程](https://markdown.com.cn/basic-syntax/)
9 0
|
1月前
|
安全 网络架构 Python
blog-engine-06-pelican 静态网站生成 支持 markdown 和 reST 语法
这篇内容介绍了多个静态博客引擎的对比及详细教程,包括 Jekyll、Hugo、Hexo、Pelican、Gatsby、VuePress、Nuxt.js 和 Middleman。重点讲述了 Pelican,一个Python编写的静态博客生成器,其特点是静态生成、Markdown写作、丰富的主题和插件系统,以及简单的部署。安装Pelican需要先安装Python,然后通过pip安装Pelican并使用pelican-quickstart初始化博客。文章还提到了Pelican的优点,如速度快、写作体验好、社区支持和高度可定制,但也指出其静态性质和学习曲线较陡峭的不足之处。
|
1月前
|
IDE 数据可视化 数据挖掘
Jupyter Notebook使用教程——从Anaconda环境构建到Markdown、LaTex语法介绍
Jupyter Notebook使用教程——从Anaconda环境构建到Markdown、LaTex语法介绍
296 2
|
1月前
Markdown的基本语法(一)
Markdown的基本语法(一)
|
1月前
|
开发者
阿里云开发者社区Markdown语法
【2月更文挑战第1篇】
508 0
阿里云开发者社区Markdown语法
|
10月前
轻松写作利器——Markdown常用语法介绍
家人们,今天我想向大家介绍一种广泛应用于写作和文档编辑的工具——Markdown。作为一种简单而高效的标记语言,Markdown在技术圈和写作领域越来越受欢迎。无论你是写程序代码、博客文章还是撰写文档,Markdown都能帮助你以简洁的方式展现内容。让我们一起来了解Markdown的常用语法吧!
75 0
轻松写作利器——Markdown常用语法介绍
|
1月前
|
前端开发 API
MarkDown基础语法
MarkDown基础语法
91 0
|
6月前
|
Dart Shell pouch
markdown中快速插入Emoji表情包语法速查表!!!
markdown中快速插入Emoji表情包语法速查表!!!