Markdown基础语法

Markdown 是一种轻量级的标记语言,允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的 XHTML(或者 HTML)文档。

分割线-1.webp

标题 (Headers)

使用 # 号来表示标题,# 的数量表示标题的级别。一级标题使用一个 #,二级标题使用两个 #,以此类推,最多支持六级标题。

Markdown

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

段落和换行 (Paragraphs and Line Breaks)

段落是由一个或多个连续的文本行组成,它们之间由一个或多个空行分隔。

如果需要强制换行(创建一个 <br> 标签),可以在一行的末尾输入两个或多个空格,然后按回车键。

强调 (Emphasis)

  • 加粗 (Bold): 使用两个星号 ** 或两个下划线 __ 包裹文本。

    Markdown

    1
    2
    **这是加粗的文字**
    __这也是加粗的文字__
  • 斜体 (Italic): 使用一个星号 * 或一个下划线 _ 包裹文本。

    Markdown

    1
    2
    *这是倾斜的文字*
    _这也是倾斜的文字_
  • 加粗并倾斜 (Bold and Italic): 使用三个星号 *** 或三个下划线 ___ 包裹文本。

    Markdown

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

实在记不住也是有快捷键操作的哦

  • 加粗ctrl+b
  • 斜体ctrl+i

列表 (Lists)

  • 无序列表 (Unordered Lists): 使用星号 *、加号 + 或减号 - 作为列表标记。

    Markdown

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    * 项目一
    * 项目二
    * 项目三

    + 项目一
    + 项目二
    + 项目三

    - 项目一
    - 项目二
    - 项目三
  • 有序列表 (Ordered Lists): 使用数字加一个英文句点 . 作为列表标记。

    Markdown

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

任务列表

任务列表使您可以创建带有复选框的项目列表。在支持任务列表的 Markdown 应用程序中,复选框将显示在内容旁边。要创建任务列表,请在任务列表项之前添加破折号 - 和方括号 [ ],并在 [ ] 前面加上空格。要选择一个复选框,请在方括号 [x] 之间添加 x 。

1
2
3
- [x] Write the press release
- [ ] Update the website
- [ ] Contact the media

渲染效果如下:

  • Write the press release
  • Update the website
  • Contact the media

创建任务:

  • - + 空格 +[ ] +空格 + 任务列表内容 ( 中括号 [ ]  里面必须有个空格)
  • 或者更简单点,对着某个行文字,按下“Ctrl + L”
  • 完成任务 - 在渲染界面,直接鼠标左键点击 mm - 在源代码界面,在中括号内输入  英文字母 x - 部分编辑器,在 中括号内 输入 任意字符 都可以打   ( 例如  Obsidian )
  • 任务列表也是可以缩进 + 退格的,操作跟 无序列表、有序列表一样
  • 行内式链接 (Inline Links): 链接文字用方括号 [] 包裹,后面紧跟着括号 () 包裹的 https://www.google.com/search?q=URL,还可以在 https://www.google.com/search?q=URL 后面用引号添加可选的 title 属性。

    Markdown

    1
    这是一个 [链接示例](http://example.com "链接标题")。
  • 参考式链接 (Reference Links): 将链接的定义放在文档的其他地方。

    Markdown

    1
    2
    3
    这是一个 [参考式链接的例子][id]。

    [id]: http://example.com "可选的标题"

链接可以直接复制粘贴过来,会自动识别哦,链接名称可自定义修改

图片 (Images)

图片的语法和链接非常相似,只是在方括号前多一个感叹号 !

  • 行内式图片 (Inline Images):

    Markdown

    1
    ![替代文本](图片URL "可选标题")

    例如:

    Markdown

    1
    ![谷歌Logo](https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png "谷歌Logo")
  • 参考式图片 (Reference Images):

    Markdown

    1
    2
    3
    ![替代文本][图片id]

    [图片id]: 图片URL "可选标题"

如果要配图的话建议使用图床链接,不然会产生碎片化文件,还要专门整理图片,并不是很方便

代码 (Code)

  • 行内代码 (Inline Code): 使用反引号 ` 包裹代码。

    Markdown

    1
    这是一个 `<code>` 示例。
  • 代码块 (Code Blocks): 使用三个反引号 ``` 或者四个空格(或一个制表符)缩进。推荐使用三个反引号,并可以指定语言类型以实现语法高亮。

    Markdown

    1
    2
    3
    4
    ```javascript
    function greet() {
    console.log("Hello, world!");
    }
    1
    2
    3
    4
    5
    6
    7

    或者

    // 这是一个使用空格缩进的代码块
    int main() {
    return 0;
    }

插入代码可以直接右键-插入-代码块,会更方便些一些哦。

引用 (Blockquotes)

使用大于号 > 来创建引用; > + 文本内容 (不需要空格)。

渲染效果如下:

1
2
3
4
> 这是一个引用。
>
> 这是引用的第二段。
>> 这是一个嵌套的引用。

这就是引用效果

分隔线 (Horizontal Rules)

可以在一行中使用三个或更多的星号 ***、减号 --- 或下划线 ___ 来创建分隔线,行内不能有其他东西。

Markdown

1
2
3
***
---
___

关于分割线,不同主题渲染效果也不同,
比如我觉得主题自带的分割线不美观,但我又不会通过代码修改,于是我就自己做了一个图片,
我的分割线其实是一个图片哦😜~~~~~

分割线-1.webp

转义字符 (Escaping Characters)

如果你想在 Markdown 中显示一些具有特殊含义的字符,比如 *#\ 等,可以在这些字符前面加上反斜杠 \ 进行转义。

Markdown

1
2
3
\*这不是斜体\*
\# 这不是标题
\\ 这是一个反斜杠

列表、标题类的符号需要空格才会生效,加粗、强调类的符号可以直接输入。
所以有时候如果输入了符号没效果,不妨再按下空格试试看😊

最后还有一个是关于emoji的,可以使用windows的快捷键win+; 🤭

分割线-1.webp

由于博客笔记全都是用Obsidian来编辑管理的,所以对Markdown语法做个总结,
加深记忆,方便学习使用,最后放一下系统的语法教程及在线体验连接。
Markdown 基本语法 | Markdown 教程
在线markdown编辑器