liangbm3's blog

Back

Markdown是一种轻量级标记语言,排版语法简洁,让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档,可与HTML混编,可导出 HTML、PDF 以及本身的 .md 格式的文件。因简洁、高效、易读、易写,Markdown被大量使用,如Github、Wikipedia、简书等。


1. 速查表#

元素Markdown 语法
标题(Heading)# H1
粗体(Bold)**bold text**
斜体(Italic)*italicized text*
引用块(Blockquote)> blockquote
有序列表(Ordered List)1. First item
无序列表(Unordered List)- First item
代码(Code)`code`
分隔线(Horizontal Rule)---
链接(Link)[title](https://www.example.com\)
图片(Image)![alt text](image.jpg)
表格(Table)|标题|标题|
|---|---|
|内容|内容|
代码块(Fenced Code Block)```
{
“firstName”: “John"
"lastName”: “Smith”,
“age”: 25
}
```
删除线(Strikethrough)~~The world is flat.~~
任务列表(Task List)- [x] Write the press release
- [ ] Update the website
- [ ] Contact the media

2. 具体语法#

2.1. 标题语法#

在单词或短语前面添加井号 (#) 。# 的数量代表了标题的级别。例如,添加三个 # 表示创建一个三级标题 (<h3>)

### My Header
markdown

考虑到兼容问题,#和标题直接要有空格

2.2. 段落语法#

使用空白行将一行或多行文本进行分隔。不要用空格(spaces)或制表符( tabs)缩进段落。

2.3. 换行语法#

  • 可以在一行的末尾添加两个或多个空格,然后按回车键,即可创建一个换行(<br>)。 几乎每个 Markdown 应用程序都支持两个或多个空格进行换行,称为结尾空格(trailing whitespace) 的方式。

  • 几乎每个 Markdown 应用程序都支持另一种换行方式:HTML 的 <br> 标签。

    hello world<br>
    hello world
    markdown

2.4. 强调语法#

2.4.1 粗体#

在单词或短语的前后各添加两个星号(asterisks)

**加粗**
markdown

2.4.2 斜体#

在单词或短语前后添加一个星号(asterisk)

*斜体*
markdown

2.4.3 粗体和斜体#

要同时使用用粗体和斜体时,在单词或短语的前后各添加三个星号。

***加粗和斜体***
markdown

2.5. 引用语法#

要创建块引用,请在段落前添加一个>符号。

> 引用块
markdown

如果引用想包含多个段落,要在段落之间的空白行添加一个>符号。

> 第一段
>
> 第二段
markdown

块引用可以嵌套。在要嵌套的段落前添加一个>>符号。

> 引用块
>> 引用块里面的引用块
markdown

2.6. 列表语法#

有序列表用数字

1. 第一点
2. 第二点
markdown

无序列表用+ , - ,*,一般用-

- 内容
- 内容
markdown

2.7. 代码语法#

行内代码,将将目标包裹在反引号(`)中。

你好,`code`行内代码
markdown

如果单词或短语中包含一个或多个反引号,则可以通过将单词或短语包裹在双反引号(“)中.

你好,``code``行内代码
markdown

代码块使用三个反引号(```),要添加语法突出显示,可以代码块之前的反引号旁边指定一种语言。

```python
print("hello world")
```
markdown

2.8. 分割线语法#

要创建分隔线,在单独一行上使用三个或多个破折号 (---) ,并且不能包含其他内容。为了兼容性,分隔线的前后都要添加空白行。

内容1

---

内容2
markdown

2.9. 链接语法#

超链接Markdown语法代码:

[超链接显示名](超链接地址 "超链接title")
markdown

使用尖括号可以很方便地把URL或者email地址变成可点击的链接。

<https://markdown.com.cn>
markdown

2.10. 图片语法#

图片语法比链接语法多一个感叹号 (!),然后在方括号增加替代文本,图片链接放在圆括号里,括号里的链接后可以增加一个可选的图片标题文本。

![图片alt](图片链接 "图片title")
markdown

2.11. 表格#

使用三个或多个连字符(---)创建每列的标题,并使用管道(|)分隔每列。您可以选择在表的任一端添加管道。

| Syntax      | Description |
| ----------- | ----------- |
| Header      | Title       |
| Paragraph   | Text        |
markdown

您可以通过在标题行中的连字符的左侧,右侧或两侧添加冒号(:),将列中的文本对齐到左侧,右侧或中心。中间对齐示例

| Syntax      | Description |
| :---------: | :---------: |
| Header      | Title       |
| Paragraph   | Text        |
plaintext

2.12. 删除线#

在单词前后使用两个波浪号~~

~~删除~~
plaintext

2.13. 使用 Emoji 表情#

有两种方法可以将表情符号添加到Markdown文件中:

  • 将表情符号复制并粘贴到Markdown格式的文本中
  • 键入emoji shortcodes。

在大多数情况下,可以简单地从Emojipedia等来源复制表情符号并将其粘贴到文档中。 还可以通过键入表情符号短代码来插入表情符号。这些以冒号开头和结尾,并包含表情符号的名称。 表情简码表

2.14 任务列表#

要创建任务列表,需要在任务列表项之前添加破折号-和方括号[ ],并在[ ]前面加上空格。要选择一个复选框,请在方括号[]里面添加 x即可 。

- [x] Write the press release
- [ ] Update the website
- [ ] Contact the media
markdown

3. 参考资料#

Markdown 教程

Markdown 简明教程
https://liangbm3.site/blog/markdown-jian-ming-jiao-cheng
Author liangbm3
Published at 2024年10月26日
Comment seems to stuck. Try to refresh?✨