Markdown基本语法

"轻量级标记语言"

Posted by xuhao on April 24, 2024

“省略掉非必需的字,这样读者就会注意到你想保留的。 ”

Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后转换成结构化的HTML代码。Markdown拥有多种优势,这使得它在各种场景下非常受欢迎,特别是在写作、编程和教育领域。

一、Markdown基本语法

xxxxxxxxxx function WebForm_DoPostBackWithOptions(options) {var validationResult = true;​if (validationResult) {    if ((typeof(options.actionUrl) != “undefined”) && (options.actionUrl != null) && (options.actionUrl.length > 0)) {        theForm.action = options.actionUrl;   }    if (options.trackFocus) {        var lastFocus = theForm.elements[“__LASTFOCUS”];        if ((typeof(lastFocus) != “undefined”) && (lastFocus != null)) {            if (typeof(document.activeElement) == “undefined”) {                lastFocus.value = options.eventTarget;           }            else {                var active = document.activeElement;                if ((typeof(active) != “undefined”) && (active != null)) {                    if ((typeof(active.id) != “undefined”) && (active.id != null) && (active.id.length > 0)) {                        lastFocus.value = active.id;                   }                    else if (typeof(active.name) != “undefined”) {                        lastFocus.value = active.name;                   }               }           }       }   }}if (options.clientSubmit) {    __doPostBack(options.eventTarget, options.eventArgument);}javascript

1. 标题

Markdown 使用井号(#)来表示标题,从一级标题到六级标题:

1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

2. 段落与换行

普通的文本将直接作为段落。为了在Markdown中创建一个新段落,你需要在行末留下一个以上的空格然后敲回车。

3. 加粗与斜体

1
2
3
*斜体* 或 _斜体_
**加粗** 或 __加粗__
**_加粗斜体_** 或 __*加粗斜体*__

4. 列表

无序列表使用星号、加号或是减号作为列表标记:

1
2
3
* 列表项一
* 列表项二
* 列表项三

有序列表使用数字后跟一个点号:

1
2
3
1. 第一个项目
2. 第二个项目
3. 第三个项目

5. 链接与图片

链接和图片也很容易添加:

1
2
[链接文本](URL)
![替代文字](图片URL)

6. 引用

引用文本前使用 >

1
> 这是一个引用。

7. 代码

在Markdown中,你可以使用反引号 来创建内嵌代码,例如 printf()。多行代码可以使用三个反引号或者四个空格的缩进:

1
2
3
4
5
#include <stdio.h>
int main() {
printf("Hello, world!");
return 0;
}

8. 水平线

你可以使用三个或更多的星号、减号或下划线来创建一条水平线:

1
2
3
---
****
___

9. 表格

Markdown 表格看起来像这样:

1
2
3
4
| 标题1 | 标题2 | 标题3 |
|-------|-------|-------|
| 行1列1 | 行1列2 | 行1列3 |
| 行2列1 | 行2列2 | 行2列3 |

二、Markdown优势

以下是Markdown的一些主要优势:

1. 易于学习和使用

Markdown 的语法极其简单,学习成本低。大多数基本元素(如标题、段落、列表和链接)都能够通过简单直观的标记来实现。这使得即使是计算机技术初学者也能快速上手并使用 Markdown。

2. 可读性强

Markdown 编写的文本即使在没有格式化的情况下也非常容易阅读。文本的结构清晰,标记符号直观,不像某些HTML标签那样会干扰文本的阅读。

3. 广泛支持

Markdown 已被许多平台和工具采用。例如,GitHub、Bitbucket 和 Reddit 都支持使用 Markdown 来格式化文本。此外,许多静态站点生成器也支持 Markdown,使得它成为创建博客和文档的流行选择。

4. 灵活和兼容

Markdown 文件是纯文本,因此它们与所有操作系统兼容,并且可以被任何文本编辑器打开。此外,Markdown 可以轻松转换成 HTML 或其他格式,使其非常适合网页内容的编写和其他需要转换格式的场景。

5. 轻量级

由于 Markdown 是纯文本,它的文件通常非常小,易于管理和分享。这对于需要版本控制的项目尤为重要,因为纯文本文件更容易进行差异比较。

6. 高度可扩展

虽然基本的 Markdown 语法已经能满足大部分需求,但是许多实现还支持扩展,如表格、脚注、定义列表等。这些扩展增强了 Markdown 的功能,同时保持了其简洁性。

7. 整合现代工作流

Markdown 文件可以轻松整合到现代开发和文档工作流中,例如与版本控制系统(如 Git)配合使用,或者整合进自动化文档生成工具链中。

总之,Markdown 的优势在于它的简单性、灵活性和广泛的适用性,使它成为编写和共享文档的强大工具,尤其是在需要清晰文档结构和轻量级文本处理的场合。