Markdown常用语法介绍

Markdown常用语法介绍
Markdown是一种使用一定的语法将普通的文本转换成HTML标签文本的编辑语言，它的特点是可以使用普通的文本编辑器来编写，只需要按照特定的语法标记就可以得到丰富多样的HTML格式的文本。本文就来介绍一些常用的Markdown语法以及推荐几款方便又实用的Markdown编辑器。

换行问题
换行是markdown最基本的语法规则，也是它不同于普通文本的地方，想要在某一行之后进行换行只按常规的Enter键是不行的。换行有3种方式：

在行的末尾添加至少两个空格，然后再接Enter另起一行；
第2种方式是在需要换行的两行内容之间空一行；
第3种方式是在需要换行的内容末尾添加一个换行标签，也就是<br>标签。
标题分级
在当前行之前输入 “#”+"空格"可以使当前行被识别为标题

"# " -> 一级标题是
"## " -> 二级标题
"### " -> 三级标题

标题分级另一种写法
在当前行的下一行输入一个或者多个"=“和”-"可以使当前行被识别为标题

“这是一个一级标题”
“=”

“这是一个二级标题”
“-”

分割线
使用三个或以上的 “-” 或者 “*” 表示(混合的不行)，且这一行只有符号，注意不要被识别为二级标题即可，意思是上面需要是空行，例如中间或者前面可以加空格。

语法

***
******
---
------

斜体和粗体
使用 (*或者_ )和( **或者__) 分别表示斜体和粗体，删除线使用两个 ~ 表示

语法

*我是斜体*
_我是斜体_
**我是加粗**
__我是加粗__
~~我是删除~~
***我是又粗又斜***
___我是又粗又斜___

超链接和图片引用
超链接
内联超链接
使用[链接文字](链接地址)来表示，如果要给链接一个提示信息，可以在链接用引号把文字包围起来，就像这样[链接文字](链接地址+空格+"文字说明")

语法

[链接例子《就是外在文字》](http://www.baidu.com/" 我是说明文字：我其实就是HTML 的<a> 标签的 Title 属性")

自动超链接
以比较简短的自动链接形式来处理网址和电子邮件信箱，只要是用<>包起来， Markdown 就会自动把它转成链接

语法

<http://example.com/>

引用式链接
在任意地方使用[链接引用标记]:链接地址+空格+"文字说明" 来定义引用的链接地址,然后使用[链接文字][链接引用标记]放在需要插入链接的地方

语法

[link1]:http://www.baidu.com/ “baidu.com 其实就是HTML 的<a> 标签的 Title 属性”
[引用式链接例子《就是外在文字》][link1]

引用式链接-简化
该功能让你可以省略指定链接标记，这种情形下，链接标记会视为等同于链接文字，只要在链接文字后面加上一个空的方括号，如果你要让 “Google” 链接到 google.com,这么写就行

语法

[Google][]
[Google]: http://google.com/

图片引用
内联式图片引用
图片引用仅在超链接前多了一个 ! ，一般是![图片文字](图片地址+空格+"文字说明")

语法


引用式图片引用
在任意地方使用[图片引用标记]:图片地址+空格+"文字说明" 来定义引用的图片链接地址,然后使用[图片文字][图片引用标记]放在需要插入图片链接的地方

语法

[link2]:http://www.baidu.com/images/logo.png “baidu.com 其实就是HTML 的<a> 标签的 Title 属性”
![引用式图片链接例子《就是Alt属性》][link2]

带有链接的图片
部分markdown编辑器只需要将链接代码套在图片代码外边就可以实现。

语法

[](http://www.baidu.com/ “链接说明文字”)

无序列表
使用 -、+ 和 *+空格 +文字内容 表示无序列表
可用tab 或者空格 + -、+ 或者 * +文字内容使列表嵌套
成功嵌套的条件是下一层的-、+ 和 * 的前面的空白长度满足以下条件

tab长度×(层数-1) < 空白长度 ≤ tab长度×层数
1
 + 第一层
   * 第二层
    + 第三层

 + 再来一个第一层

有序列表
使用 1. +空格 +文字内容 表示有序列表，可嵌套。
可用tab 或者空格 + -、+ 或者 * +文字内容使列表嵌套
成功嵌套的条件是下一层的-、+ 和 * 的前面的空白长度满足以下条件

tab长度×(层数-1) < 空白长度 ≤ tab长度×层数
1
语法

 1. 第一层
   1. 第二层
    1. 第三层

  2. 再来一个第一层

实例

第一层
第二层.1
第二层.2
第三层.1
第三层.2
第二层.3
在列表结束敲二个空行，在第二个空行中写入任何内容都可以重开一个计数列表
文字引用
使用 > 表示，可以有多个 >，表示层级更深

要从深层到浅层需要在浅层上方留一个有与层数相同个数 >的空行

语法

>文字内容
>文字内容
>>文字内容
>
>文字内容
>文字内容

实例

文字内容
文字内容

文字内容

文字内容
文字内容

行内代码块
使用 " ` " 把代码包围起来即可

语法

`a = 1`

如果要在代码区段内插入反引号，你可以用多个反引号来开启和结束代码区段：

语法
`` There is a literal backtick (`) here.``

代码块
方法一
使用四个空格缩进表示代码块，

语法

  import os
  print("hello world")
  def show_time():
  return time.time()
1
2
3
4
方法二
一些 IDE 支持行数提示和着色，一般使用三个 " ` " 表示，例如
代码块使用3个 " ` "包围起来表示，而且代码块的第一行的3个 " ` " 后面可以写上代码的编程语言，方便Markdown转化之后进行高亮显示，如写上python或者js

语法

```python
import os
print("hello world")
def show_time():
return time.time()
`` `
1
2
3
4
5
6
表格
表格由3个部分组成

第一个部分是表格的标题，使用|来作为列的分割
第二个部分是表示列的对齐方式，有左对齐、居中对齐和居右对齐三种类型，直接看例子吧， --- 表示了默认的左对齐， :--- 表示 左对齐 ， ---: 表示 右对齐 ， :---: 表示居中对齐
第三个部分就是内容了，表示方式跟标题一样，可以有多行

语法

|左对齐标题|右对齐标题|居中对齐标题|
|-|------: |:------: |
|居左|居右|居中|
|测试文本|测试文本|测试文本|

实例

左对齐标题    右对齐标题    居中对齐标题
居左    居右    居中
测试文本    测试文本    测试文本
流程图
不同的Markdown解析器原理不同，不一定支持流程图
obsidian 支持 mermaid 流程图。其他的流程图也许要安装插件
mermaid文档: https://mermaid-js.github.io/mermaid/#/README
mermaid在线编辑器: https://mermaid-js.github.io/mermaid-live-editor

语法

  ```mermaid 
  sequenceDiagram
  Alice->>John: Hello John, how are you?
  loop Healthcheck
  John->>John: Fight against hypochondria
  end
  Note right of John: Rational thoughts!
  John-->>Alice: Great!
  John->>Bob: How about you?
  Bob-->>John: Jolly good!
  ```
1
2
3
4
5
6
7
8
9
10
11
实例

Alice
John
Bob
Hello John, how are you?
Fight against hypochondria
loop
[Healthcheck]
Rational thoughts!
Great!
How about you?
Jolly good!
Alice
John
Bob
数学公式
支持 LaTeX 编辑显示支持，
使用 $ 表示，其中一个 $ 表示在行内，两个 $ 表示独占一行。

eg : ∑ i = 1 n a i = 0 \sum_{i=1}^n a_i=0∑ 
i=1
n
​
 a 
i
​
 =0

参考教程：https://1024th.github.io/MathJax_Tutorial_CN

推荐一个常用的数学公式在线编译网站：https://www.latexlive.com

HTML引用
直接在Markdown里面写HTML即可

CSS 样式相关
样式标签
<b>加粗</b>
<strong>加粗</strong>
<i>倾斜</i>
<em>倾斜</em>
<u>下划线</u>
<ins>下划线</ins>
<s>删除线</s>
<del>删除线</del>
<sub>下标</sub>
<sup>上标</sup>

内联样式
<b style=“font-size:80px; color:red”>加粗</b>

<style>标签
<style>
h1{
font-size:80px;
color:#7ecef4;
text-intent:10px;
}
</style>

<link>引用外部CSS
<link href=“main.css” rel=“stylesheet”>

这种方式，某些Markdown渲染器可以，反正obsidian是不行

HTML 内容相关
在Markdown中可以展示出网页内容
支持的也就是普通的内容，交互式的标签基本都被和谐了
HTML教程：https://www.runoob.com/html/html-tutorial.html

例子，用html的 <a> 和 <img> 标签实现带连接的图片

<a href =“超链接地址”><img src=“图片地址”></a>

JavaScript 脚本相关
很多Markdown渲染器是不允许js跑起来的

外部引用和直接写这两种基本都跑不起来
<script src=“javascript.js”></script>

<script>
console.log(“hello world!”)
</script>

内联事件的js可能可以跑起来,反正obsidian是不行
<div οnclick=“(function(){ alert(1)})()”>js测试按钮</div>

反斜杠转义
由于Markdown的语法基本都是用的符号表示，所以当需要直接输出某些特定的符号的时候，就必须使用反斜杠的转义作用了，使用方法很简单，跟大部分的编程语言的用法一样，只需要在特定的符号前面加上一个反斜杠就可以了，例如输出\本身，就需要使用\\来表示了。

Todo List
-/+/*+空格+[+空格/x+] +空格+文字内容

语法

- [ ] 待办事项
- [x] 已完成的待办事项

实例

 待办事项
 已完成的待办事项
脚注
在文档末尾写上[+^+数字+]:+文字内容 声明一个脚注
然后就跟文献引用一样，在要引用该脚注的文字后插入[+^+数字+]即可

语法

该方法根据实验证明有效[^1]
[^1]:文章链接

感谢您花费时间阅读，本文内容可能有疏漏之处，欢迎更改指正。
————————————————
版权声明：本文为CSDN博主「海星啊」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。
原文链接：https://blog.csdn.net/weixin_43863919/article/details/124648510