Markdown语法速查与高级技巧

#markdown #写作 #教程
Table of Contents

Markdown:内容创作的利器

Markdown是一种轻量级的标记语言,以其简洁的语法和极高的易读性,成为现代内容创作者的宠儿。无论是在博客、论坛、笔记应用,还是在文档编写中,Markdown都能让你专注于内容本身,而无需纠结于复杂的排版。狗子28官方网站的内容发布,也广泛受益于Markdown的便捷。

Markdown基础语法

掌握Markdown的基础语法,是高效写作的第一步。

1. 标题 (Headings)

Markdown使用井号(#)来表示标题的级别,井号的数量对应标题的层级。

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

2. 段落 (Paragraphs)

段落之间通过一个或多个空行来分隔。连续的文本行会被视为同一个段落。

1
2
3
这是第一个段落。

这是第二个段落,它和第一个段落之间有一个空行。

3. 强调 (Emphasis)

  • 粗体:使用两个星号(**)或两个下划线(__)包裹文本。 **加粗文本**__加粗文本__
  • 斜体:使用一个星号(*)或一个下划线(_)包裹文本。 *斜体文本*_斜体文本_
  • 粗斜体:结合使用星号或下划线。 ***粗斜体文本***___粗斜体文本___

4. 列表 (Lists)

无序列表 (Unordered Lists)

使用星号(*)、加号(+)或减号(-)作为列表标记,标记后需要一个空格。

1
2
3
4
5
* 项目一
* 项目二
  * 子项目二之一
  * 子项目二之二
* 项目三

有序列表 (Ordered Lists)

使用数字加英文句点(.)作为列表标记,数字的顺序不重要,Markdown会自动编号。

1
2
3
4
5
1. 第一项
2. 第二项
   1. 子项一
   2. 子项二
3. 第三项

Markdown链接有两种形式:行内链接和引用链接。

[链接文本](URL "可选的标题")

例如:[狗子28官网](https://www.gouzi28.com "访问狗子28官方网站")

1
2
3
4
5
这是一个[行内链接][id]的例子。
这是一个[引用链接][another-id]。

[id]: https://www.example.com "可选的标题"
[another-id]: https://www.anotherexample.com

6. 图片 (Images)

图片语法与链接类似,只是在方括号前多一个感叹号(!)。

![图片alt文本](图片URL "可选的标题")

例如:![狗子28 Logo](/uploads/content/35889d7106656595.png "狗子28 Logo")

7. 代码 (Code)

  • 行内代码:使用一个反引号(`)包裹。 这是一个行内代码

  • 代码块:使用三个反引号(`)包裹,并可以指定语言高亮。

    1
    2
    
    def hello_world():
        print("Hello, Markdown!")
    

8. 引用 (Blockquotes)

在段落的开头使用大于号(>)。

1
2
3
4
5
6
> 这是引用文本。
>
> 它可以包含多个段落,
> 也可以嵌套其他Markdown元素。
>
> > 这是一个嵌套的引用。

9. 分割线 (Horizontal Rules)

使用三个或更多的星号(*)、减号(-)或下划线(_)来创建分割线。

1
2
3
---
***
___

Markdown高级技巧

在掌握了基础语法后,一些高级技巧可以帮助你创建更复杂、更具表现力的内容。

1. 表格 (Tables)

Markdown表格通过竖线(|)和横线(-)来定义。第一行是表头,第二行是分隔表头和表体的横线,其下的行是表格内容。冒号(:)用于控制对齐方式。

1
2
3
4
| 列1 (左对齐) | 列2 (居中对齐) | 列3 (右对齐) |
| :----------- | :----------: | -----------: |
| 内容A1       | 内容B1       | 内容C1       |
| 内容A2       | 内容B2       | 内容C2       |

2. 删除线 (Strikethrough)

使用两个波浪线(~~)包裹文本。

~~这是被删除的文本~~

3. 任务列表 (Task Lists)

在列表项中使用方括号 [ ] 来表示未完成的任务,或 [x] 表示已完成的任务。

1
2
3
- [x] 完成Markdown教程
- [ ] 撰写博客文章
- [ ] 回复用户邮件

直接写URL或邮箱地址,Markdown会自动将其转换为可点击的链接。

https://www.gouzi28.com contact@example.com

5. HTML嵌入

Markdown允许直接嵌入HTML代码,这为更复杂的布局和样式提供了可能。

1
<p style="color: blue;">这段文本将以蓝色显示。</p>

为什么选择Markdown?

Markdown的优势在于其:

  • 简洁高效:语法简单,上手快,写作速度提升。
  • 易读性强:纯文本格式,即使不渲染,也易于阅读。
  • 跨平台兼容:纯文本文件,可在任何操作系统上编辑和查看。
  • 广泛支持:被众多平台和工具支持,便于内容迁移。

狗子28官方网站鼓励内容创作者拥抱Markdown,用最简单的方式,创造最优质的内容。