markdown语法
最近更新:2025-10-20   |   字数总计:796   |   阅读估时:3分钟   |   阅读量:
  1. 基础语法
  2. 拓展语法

基础语法

  • 标题语法

添加 # 号,# 的数量代表标题的级别,以三级标题为例:

1
### title
  • 段落语法

一段直接在空行敲即可。

建议不要使用 space 和 tab 键缩进段落。

  • 换行语法

可以使用专门的换行标签,同html。

1
<br>

例:小草偷偷地从土里钻出来,嫩嫩的,绿绿的。
园子里,田野里,瞧去,一大片一大片满是的。坐着,躺着,打两个滚,踢几脚球,赛几趟跑,捉几回迷藏。风轻悄悄的,草软绵绵的。

注:与直接按Enter不同。( But Shift+Enter is alright. )

  • 强调语法

加粗:使用 ** 包围文本。

斜体:使用 * 包围文本。

加粗和斜体:使用 *** 包围文本。

eg: hello I am jay1an –> hello I am jay1an.

1
*hello* **I** am ***jay1an***
  • 引用语法

使用符号 >

hello I am jay1an

1
> hello I am jay1an
  • 列表语法

    • 有序列表

      直接使用 ‘数字+.’ 的方式,第一个必须是1

    • 无须列表

      可以使用- * + (可以支持子列表 & 有序无序可混用)

    若要保留列表连续性的同时添加其他元素,则要增加四个空格符

eg:

  • This is the first list item.

  • Here’s the second list item.

    A blockquote would look great below the second list item.

  • And here’s the third list item.

1
2
3
4
5
6
*   This is the first list item.
* Here's the second list item.

> A blockquote would look great below the second list item.

* And here's the third list item.
  • 代码语法

使用反引号 `

hello I am jay1an

1
`hello I am jay1an`
  • 分割线语法

使用多个 * 或者 - 或者 _




效果一致

1
2
3
---
***
___
  • 链接语法

链接文本放在中括号内,链接地址放在后面的括号中,链接title可选。

超链接Markdown语法代码:[超链接显示名](超链接地址 "超链接title")

注:地址之后有一个空格

jay1an

1
[jay1an](https://jay1an.github.io/ "I am title")
  • 图片语法

插入图片Markdown语法代码:![图片alt](图片链接 "图片title")

方括号增加替代文本,title可选。

jay1an's pic

1
![jay1an's pic](https://jay1an.github.io/img/favicon.webp "I am title")
  • 转义语法

在需要转义的字符前加上 \

## this is should be a title

1
\## this is should be a title

还有一些 & –> &amp; < –> &lt; (查阅官方文档Markdown 转义字符语法 | Markdown 官方教程

拓展语法

  • 制表

    使用至少3个连字符-,并且使用管道|分割

    name age birthday
    jay1an 10086 10086

    (本网站的主题似乎不能选成功渲染表格)

    若使用Typora直接用管道分割即可生成表格,如上。

    如果使用编译器,语法如下:

    —代表分割,:代表对齐

    1
    2
    3
    4
    | Syntax      | Description | Test Text     |
    | :--- | :----: | ---: |
    | Header | Title | Here's this |
    | Paragraph | Text | And more |
  • 围栏代码块

    使用 3个反引号```,或者3个波浪号~~~

    空格后加上语言名实现语法高亮

    1
    2
    ~~~ markdown
    ``` markdown
  • 脚注

    可以单击链接以跳至页面底部的脚注内容。

    [^footnote]

[^footnote]: this is a simple footnore

1
[^footnore]: this is a simple footnote
  • 删除线

    2个波浪号 ~~包围单词

    I am not jay1an

1
~~I am not jay1an~~
  • 任务列表语法
    • study
    • eat
    • sleep
1
2
3
- [x] study
- [ ] eat
- [ ] sleep