Markdown基本语法

本文介绍了Markdown的基本语法和使用方法,包括标题、强调、列表、链接、图片、代码、引用、分隔线、删除线和表格等常用功能。Markdown是一种轻量级标记语言,语法简单易学,能帮助用户专注于内容而非排版,适合日常写作和论坛交流。

作者头像
LumiBee
22 天前 · 114658 4
分享

大家好!

​ 欢迎来到我们的社区!为了让大家能够更方便、更美观地分享想法和交流,我们的论坛支持使用 Markdown 格式来书写帖子。

什么是Markdown?

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

​ 千万不要被「标记」、「语言」吓到,Markdown的语法十分简单,常用的标记符号不超过十个,用于日常写作记录绰绰有余,不到半小时就能完全掌握。

​ 就是这十个不到的标记符号,却能让人优雅地沉浸式记录,专注内容而不是纠结排版,达到「心中无尘,码字入神」的境界。

Markdown快速上手指南

标题

想让你的文章结构更清晰?用标题!在文字前面加上 # 号(#和文字之间要有一个空格),# 的数量代表标题的级别。

Markdown

# 这是一级标题 (H1)
## 这是二级标题 (H2)
### 这是三级标题 (H3)
#### 这是四级标题 (H4)
##### 这是五级标题 (H5)
###### 这是六级标题 (H6)

显示效果:

这是一级标题 (H1)

这是二级标题 (H2)

这是三级标题 (H3)

这是四级标题 (H4)

这是五级标题 (H5)
这是六级标题 (H6)

强调

想突出某些文字?很简单!

  • 加粗 (Bold): 用两个 **__ 包裹文字。
  • 斜体 (Italic): 用一个 *_ 包裹文字。
  • 加粗并斜体 (Bold and Italic): 用三个 ***___ 包裹文字。

Markdown

**这是加粗的文字**
__这也是加粗的文字__

*这是倾斜的文字*
_这也是倾斜的文字_

***这是加粗并倾斜的文字***
___这也是加粗并倾斜的文字___

显示效果:

这是加粗的文字 这也是加粗的文字

这是倾斜的文字 这也是倾斜的文字

这是加粗并倾斜的文字 这也是加粗并倾斜的文字

列表

想列出几点内容?Markdown 支持有序列表和无序列表。

  • 无序列表 (Unordered Lists): 使用 *+- 开头,再加上一个空格。

    Markdown

    * 列表项一
    * 列表项二
      * 嵌套列表项二点一
    * 列表项三
    
    - 列表项A
    - 列表项B
    

    显示效果:

    • 列表项一

    • 列表项二

      • 嵌套列表项二点一
    • 列表项三

    • 列表项A

    • 列表项B

  • 有序列表 (Ordered Lists): 使用数字加一个英文句点 . 再加一个空格。

    Markdown

    1. 第一项
    2. 第二项
       1. 嵌套第二项的第一点
    3. 第三项
    

    显示效果:

    1. 第一项
    2. 第二项
      1. 嵌套第二项的第一点
    3. 第三项

链接

想在帖子中添加网址链接?

Markdown

[链接显示的文字](链接地址)
[访问我们的论坛](https://hivelumi.com)

https://www.google.com

显示效果:

访问我们的论坛

图片

想在帖子中插入图片?和链接的写法类似,只是在前面加一个感叹号 !

Markdown

![图片的替代文字](图片链接地址)
![这是一个Logo](https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png)

显示效果:

(提示:请确保图片链接是有效的,并且可以在公网访问。)

代码

如果你是程序员,或者想分享一段代码,Markdown 也为你准备好了。

  • 行内代码 (Inline Code): 用反引号 ``` 包裹单个词或短语。

    Markdown

    在 JavaScript 中,`console.log()` 用来打印信息。
    

    显示效果:

    在 JavaScript 中,console.log() 用来打印信息。

  • 代码块 (Code Blocks): 用三个反引号 `` 包裹多行代码。你还可以在第一组反引号后面指定语言类型,实现语法高亮。

    Markdown

    ```javascript
    function greet(name) {
      console.log("Hello, " + name + "!");
    }
    
    greet("World");
    ```
    
    ```python
    def hello(name):
        print(f"Hello, {name}!")
    
    hello("Markdown User")
    ```
    

    显示效果:

    JavaScript

    function greet(name) {
      console.log("Hello, " + name + "!");
    }
    
    greet("World");
    

    Python

    def hello(name):
        print(f"Hello, {name}!")
    
    hello("Markdown User")
    

引用 (Blockquotes)

想引用别人的话?在文字前面加上 > 符号。

Markdown

> 这是一段引用的文字。
>
> > 嵌套引用也是可以的。
>
> —— 鲁迅 (乱编的)

显示效果:

这是一段引用的文字。

嵌套引用也是可以的。

—— 鲁迅 (乱编的)

分隔线 (Horizontal Rules)

想在内容之间添加一条分隔线?使用三个或更多的 *-_

Markdown

***
---
___

显示效果:




删除线 (Strikethrough)

想给文字加上删除效果?用两个波浪线 ~~ 包裹文字。

Markdown

~~这段文字被删除了~~

显示效果:

~~这段文字被删除了~~

表格 (Tables)

创建表格稍微复杂一点,但依然很有用(写表格更好的是用markdown编辑器直接生成,这样更方便)。

Markdown

| 表头1 | 表头2 | 表头3 |
| :---- | :---: | ----: |
| 左对齐 | 居中对齐 | 右对齐 |
| 内容1 | 内容2 | 内容3 |
| 内容A | 内容B | 内容C |

显示效果:

| 表头1 | 表头2 | 表头3 | | ------ | -------- | ------ | | 左对齐 | 居中对齐 | 右对齐 | | 内容1 | 内容2 | 内容3 | | 内容A | 内容B | 内容C |

解释:

  • 第一行是表头。

  • 第二行

    | :---- | :---: | ----: |
    

    用来定义对齐方式:

    • :---- 表示该列内容左对齐。
    • :---: 表示该列内容居中对齐。
    • ----: 表示该列内容右对齐。
  • 后面的每一行都是表格的内容。

  • 每一列都用 | 分隔。


以上就是Markdown的一些常用语法,是不是很简单?

现在就尝试用 Markdown 来书写你的第一篇帖子吧!如果你在使用的过程中遇到任何问题,欢迎随时向我提问。

祝大家在论坛交流愉快!

阅读量: 114658

评论区

登录后发表评论

正在加载评论...
相关阅读

暂无相关文章推荐

返回首页浏览更多文章