Markdown语法、相关警告配置设置——持续更新

Markdown

一、配置

MD025—Multiple top level headings in the same document

同一文档只能有一个最高级的标题，默认是只能有一个1级标题。

解决

在项目文件夹中新建.markdownlint.jsonc文件，加入代码"MD025":false即可。

参数补充**

“level”：指定文档最高级的标题，默认是1。
“front_matter_title”：字符串，指定在文档开头处的front matter中的标题，这个标题将作为整篇文档的最高级标题，如果文档中再次出现最高级标题，将会给出警告。

MD010—Hard tabs

不能使用tab键缩进。

解决

在项目文件夹中新建.markdownlint.jsonc文件，加入如下代码即可。

"MD010":{
    "code_blocks":false // 指定本条规则在代码块里是否(true or false)生效
  }

MD024—Multiple headings with the same content

具有相同内容的多个标题，标题重复了。

解决

在项目文件夹中新建.markdownlint.jsonc文件，加入如下代码即可。

"MD024":{
    "siblings_only":true // 默认为false，设为true时，不同标题下的子标题内容可以重复
  }

MD033—Inline HTML

文档中不允许使用HTML语句。

解决

在项目文件夹中新建.markdownlint.jsonc文件，加入代码"MD033":false即可。

MD013—Line length

默认行的最大长度是80，此规则对代码块、表格、标题也生效。

解决

在项目文件夹中新建.markdownlint.jsonc文件，加入代码如下即可。

"MD013": {
    "code_block_line_length": 500,  // 代码行的最大长度，按实际情况调整
    "line_length": 1000 // 行的最大长度
  }

MD026—Trailing punctuation in heading

行尾输入：时触发该规则。标题行末尾不能有以下标点符号——默认值“.；；：？；；：！？”，此规则默认的是英文的标点符号，中文标点符号不在规则之内。将指定的普通或全宽度标点符号之一作为行中的最后一个字符的任何标题，都会触发此规则。

解决

在项目文件夹中新建.markdownlint.jsonc文件，加入代码如下即可。

"MD026":{
    "punctuation":".,;!，；！" //去掉了默认值中的 ：
}

参数补充**

“punctuation”：字符串，指定标题行尾不能有的标点符号，默认是".,;:!?"

二、语法

1、插入图片

![alert 文字](图片位置)

2、文本首行缩进
①半角的空格（英文下使用）：

  或  

②全角的空格（中文下使用）：

  或  

③不断行的空格：

  或  

3、插入链接
[]里面写链接的标题或描述，可以省略不加不写 ， () 里面是链接，必须有必须写

[百度](https://www.baidu.com)

百度