Markdown 标记语言旨在易于阅读、编写和理解。它的灵活性既是优点也是缺点。语法众多，因此格式可能不一致。某些构造在所有解析器中都不能很好地工作，应该避免。CommonMark 规范标准化解析器。

Markdownlint 是一个用于 Node.js 的静态分析工具，有一个标准规范，用于强制执行 Markdown 文件的标准和一致性。

Markdownlint 插件使用

markdownlint提供了多种使用场景下的解决方案，如命令行，编辑器甚至 GitHub Action。因为我平时写 Markdown 文档都是使用 VSCode，所以介绍一下 VSCode 下的使用。其他编辑器包括 VIM，Sublime 也都支持，可以前往官网查阅方法。

VSCode 需要下载插件，Ctrl+Shift+X打开插件中心，搜索Markdownlint安装即可。

安装插件后打开 Markdown 文档，如果有不符合规范的语法将会警告标识。如，标题前后没有空行，将会标识：

提示违反了第 22 条规范，第 22 条规范的就是标题前后需要有空行隔开。

目前有 53 条规范，可以在markdownlint/Rules.md查看所有规范的内容。

当然这些规范也都可以自定义是否检查，比如第 24 条规定，文档内不可以有重复的标题，但是我就有重复标题的需求，那该如何关闭这个检查呢，Markdownlint 提供了配置的方式。

Ctrl+Shift+P打开运行窗口，输入 Markdownlint，找到Creat or open the markdownlint configuration file。

创建一个配置文件，并输入以下内容，表示关闭第 24 条规范的检查：

{
  "MD024": false,
}

这样文档中将不会有第 24 条规范的检查警告，其他检查同理。

Markdownlint 自定义规则

MD001 - Heading levels should only increment by one level at a time

标题等级一次只能增加一级，不能跨级。

原理：标题代表文档的结构，跳过时可能会造成混淆 - 特别是对于可访问性场景。

MD002 - First heading should be a top-level heading

文档的第一个标题必须是最高级的标题（标题等级 1 级到 6 级逐渐降低）

MD003 - Heading style

整篇文档需要采用一致的标题格式。

MD004 - Unordered list style

无序列表格式需要一致。

MD005 - Inconsistent indentation for list items at the same level

• 同一级的列表缩进必须一致
• 在有序列表中，前面的数字序号可以左对齐，也可以右对齐

MD006 - Consider starting bulleted lists at the beginning of the line

一级列表不能缩进。

如下为报错：

Some text

  * List item
  * List item

MD007 - Unordered list indentation

无序列表嵌套缩进时默认采用两个空格。

MD009 - Trailing spaces

行尾最多可以添加两个空格，超过会给出警告，两个空格正好可以用于换行。

MD010 - Hard tabs

不能使用 tab 键缩进，要使用空格。

原理：硬制表符通常由不同的编辑器以不一致的方式呈现，并且比空格更难处理。

MD011 - Reversed link syntax

当遇到看似链接的文本，但语法似乎已反转（[] 和 () 反转）时，将触发此规则。

MD012 - Multiple consecutive blank lines

文档中不能有连续的空行，在代码块中此规则不会生效。

MD013 - Line length

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

MD014 - Dollar signs used before commands without showing output

在代码块中，终端命令前不需要有美元符号 ($) 如果代码块中既有终端命令，也有命令的输出，则终端命令前可以有美元符号 ($)。

MD018 - No space after hash on atx style heading

在"atx"格式的标题中，#号和文字间需用一个空格隔开。

MD019 - Multiple spaces after hash on atx style heading

在"atx"格式的标题中，#号和文字间只能用一个空格隔开，不能有多余的空格。

MD020 - No space inside hashes on closed atx style heading

在"closed_atx"格式的标题中，文字和前后的#号之间需用一个空格隔开。

MD021 - Multiple spaces inside hashes on closed atx style heading

在"closed_atx"格式的标题中，文字和前后的#号之间只能用一个空格隔开，不能有多余的空格。

MD022 - Headings should be surrounded by blank lines

标题行的上下行必须都是空行。

MD023 - Headings must start at the beginning of the line

标题行不能缩进。

MD024 - Multiple headings with the same content

文档不能有内容重复的标题。

MD025 - Multiple top-level headings in the same document

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

MD026 - Trailing punctuation in heading

标题行末尾不能有以下标点符号。

MD027 - Multiple spaces after blockquote symbol

创建引用区块时，右尖括号 ( > ) 和文字之间有且只能有一个空格。

MD028 - Blank line inside blockquote

两个引用区块间不能仅用一个空行隔开或者同一引用区块中不能有空行，如果一行中没有内容，则这一行要用>开头。

MD029 - Ordered list item prefix

有序列表的前缀序号格式必须只用 1 或者从 1 开始的加 1 递增数字。

MD030 - Spaces after list markers

列表（有序、无序）的前缀符号和文字之间用 1 个空格隔开 在列表嵌套或者同一列表项中有多个段落时，无序列表缩进两个空格，有序列表缩进 3 个空格。

MD031 - Fenced code blocks should be surrounded by blank lines

单独的代码块前后需要用空行隔开（除非是在文档开头或末尾），否则有些解释器不会解释为代码块

MD032 - Lists should be surrounded by blank lines

列表（有序、无序）前后需要用空行隔开，否则有些解释器不会解释为列表。

列表的缩进必须一致。

MD033 - Inline HTML

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

MD034 - Bare URL used

单纯的链接地址需要用尖括号 (<>) 包裹，否则有些解释器不会解释为链接。

MD035 - Horizontal rule style

创建水平线时整篇文档要统一 (consistent)，要和文档中第一次创建水平线使用的符号一致。

MD036 - Emphasis used instead of a heading

不能用加粗代替标题。

MD037 - Spaces inside emphasis markers

用于创建强调的符号和强调的的文字之间不能有空格。

MD038 - Spaces inside code span elements

当用单反引号创建代码段的时候，单反引号和它们之间的代码不能有空格 如果要把单反引号嵌入到代码段的首尾，创建代码段的单反引号和嵌入的单反引号间要有一个空格隔开。

MD039 - Spaces inside link text

链接名和包围它的中括号之间不能有空格，但链接名中间可以有空格。

MD040 - Fenced code blocks should have a language specified

单独的代码块（此处是指上下用三个反引号包围的代码块）应该指定代码块的编程语言，这一点有助于解释器对代码进行代码高亮。

MD041 - First line in a file should be a top-level heading

文档的第一个非空行应该是文档最高级的标题，默认是 1 级标题。

MD042 - No empty links

链接的地址不能为空。

MD043 - Required heading structure

要求标题遵循一定的结构，默认是没有规定的结构。

MD044 - Proper names should have the correct capitalization

指定一些名称，会检查它是否有正确的大写。

MD045 - Images should have alternate text (alt text)

图片链接必须包含描述文本（alt text）。

MD046 - Code block style

整篇文档采用一致的代码格式。

MD047 - Files should end with a single newline character

文档需用一个空行结尾。

MD048 - Code fence style

表示代码块的标记需要一直，可以是波浪号，也可以是点号。但是需要保持一致。

MD049 - Emphasis style should be consistent

强调符号需要一直，如斜体。

MD050 - Strong style should be consistent

加粗符号需要保持一致。

MD051 - Link fragments should be valid

锚点需要表示正确。

工作时需要开启多个标签页，在同一个窗口里打开又查找不变，于是分为多个窗口，每个窗口里的标签页工作内容一致。如所有文档放在一个窗口，需要百度，Google 搜索时用单独的一个问题搜索窗口。这样就避免每次打开窗口都要挨个点一遍。

Edge 设置

打开设置-更多工具 - 为窗口命名。即可重命名窗口

Chrome 设置

同上，路径基本一致都是在设置-更多工具中。

升级

在使用过程中发现窗口太多任务栏太挤了，Chrome 自身有标签分组的功能，其实完全可以替代窗口。也可以满足我的需求。少数派有介绍，就不造轮子了。体验一段时间确实很好用。

编码字体首要原则：等宽，等宽，还是 TMD 等宽！

JetBrains Mono

Hack

Source Code Pro

Fira Mono

Consolas

保底字体，基本上 Windows 电脑都有预装。

阅读字体

看多了黑体，其实有衬线的宋体才能体现中文文字之美。

思源宋体

华文中宋

中文等宽字体

对于既想要满足编程字体又想要中文书写的，有几款等宽中文字体也不错。

Sarasa Gothic / 更纱黑体

思源黑体/Source Han Sans

下载与安装

官网： https://keepass.info/download.html

下载完成后进行安装，默认安装位置是：C:\Program Files (x86)\KeePass Password Safe 2文件夹下，可以根据自己需要选择安装路径。

更改中文语言

中文语言包： KeePass-Chinese_Simplified

将语言包下载后复制到安装路径下的Languages文件夹下，默认为：C:\Program Files (x86)\KeePass Password Safe 2\Languages。重启软件。

点击 View->Change Language. 选择中文简体（Chinese-Simplified）。重启软件，即可完成语言更改。

中文界面：

基本使用

1.创建一个数据库

点击 文件-》新建。弹出对话框为数据库创建管理密码。这个密码是唯一需要记忆的密码。当然如果追求更高的安全性，可以点击显示高级选项，提供更多的密码选项。

2.添加记录

点击添加记录，在弹出的窗口填入相关信息。即可完成密码添加。

如果是第一次使用的网站，第一次注册密码。可以通过密码生成器，生成一个高强度的密码来添加记录。

3.创建一个密码生成模板

正常国内的网站可以使用的密码长度 6-16 位，可以使用大小写，数字，下划线。我们把这些选项勾选，密码长度设置 16 位。

点击保存并给模板设置个名字方便下次使用

如果保存后想更改一下，比如再加个可以使用空格，可以重新勾选刚刚的选项，保存时点击小三角，选择刚刚保存的方案就可以覆盖。

导入 Chrome 已保存的密码

很多小伙伴在使用 KeePass 之前肯定在 Chrome 等浏览器里也保存了很多密码。想将其导入 KeePass 方便管理。Chrome 是可以导出密码的，KeePass 也可以导入密码。

点击浏览器右上角，打开设置界面。找到密码

找到已保存的密码-》导出密码。选择方便找到的路径，保存密码记录。

打开 KeePass，点击文件-》导入，选择 Chrome 浏览器的格式。点击文件夹图标找到刚刚导出的密码文件。

高级配置

KeePass 搭配坚果云实现云同步

登录坚果云创建个人同步文件夹，若没有先注册。

最好单独建一个专门的文件夹

将已经生成的数据库上传到这个文件夹下

点击右上角进入账户信息，点击安全选项：

点击添加应用

输入应用名称，应用名称只是方便区分作用，所以和要同步的应用名称一致就好：

点击生成密码：

此时云盘端配置完成，切回到 KeePass 进行客户端配置。点击文件-》同步-》与网址（URL）同步

网址： https://dav.jianguoyun.com/dav/KeePass/keepassData.kdbx

注意：红色部分是个人同步文件夹的名称，绿色部分是上传的数据库全称，一定别忘了后缀

**用户名：**你的坚果云登录名（邮箱或者手机号）

密码：生成应用的密码，（不是登录坚果云的密码）

点击确定，此时已经可以完成同步，但是每次同步仍然需要手动确定。参考了什么值得买上小乐 CSN的方法，通过触发器实现自动同步。

触发器代码：

<?xml version="1.0" encoding="utf-8"?>
<TriggerCollection xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <Triggers>
                <Trigger>
                        <Guid>L2euC7Mr/EKh7nPjueuZvQ==</Guid>
                        <Name>SaveSync</Name>
                        <Events>
                                <Event>
                                        <TypeGuid>s6j9/ngTSmqcXdW6hDqbjg==</TypeGuid>
                                        <Parameters>
                                                <Parameter>1</Parameter>
                                                <Parameter>kdbx</Parameter>
                                        </Parameters>
                                </Event>
                        </Events>
                        <Conditions />
                        <Actions>
                                <Action>
                                        <TypeGuid>tkamn96US7mbrjykfswQ6g==</TypeGuid>
                                        <Parameters>
                                                <Parameter>SaveSync</Parameter>
                                                <Parameter>0</Parameter>
                                        </Parameters>
                                </Action>
                                <Action>
                                        <TypeGuid>Iq135Bd4Tu2ZtFcdArOtTQ==</TypeGuid>
                                        <Parameters>
                                                <Parameter>https://dav.jianguoyun.com/dav/keePass/passwordSync.kdbx</Parameter>
                                                <Parameter>123456</Parameter>
                                                <Parameter>123456</Parameter>
                                        </Parameters>
                                </Action>
                                <Action>
                                        <TypeGuid>tkamn96US7mbrjykfswQ6g==</TypeGuid>
                                        <Parameters>
                                                <Parameter>SaveSync</Parameter>
                                                <Parameter>1</Parameter>
                                        </Parameters>
                                </Action>
                        </Actions>
                </Trigger>
        </Triggers>
</TriggerCollection>

复制触发器代码，点击工具-》触发器，点击工具-》从剪切板粘贴触发器：

导入成功后，在触发器页面会多一个触发器：

双击打开SaveSync,打开最后一个动作窗口：

双击中间的条目：

将信息换成同步云盘的信息：

文件/网址： https://dav.jianguoyun.com/dav/KeePass/keepassData.kdbx

注意：红色部分是个人同步文件夹的名称，绿色部分是上传的数据库全称，一定别忘了后缀

**IO 连接 - 用户名：**你的坚果云登录名（邮箱或者手机号）

IO 连接 - 密码：生成应用的密码，（不是登录坚果云的密码）

点击确定，回到主页面，点击工具-》选项

找到 高级，向下翻，在文件输入/输出连接 栏目里找到 写入数据库时使用文件交换 此项不勾选

点击确定，返回主页面。此时点击保存按钮或者 Ctrl+S。即可与云盘进行同步。

Chrome 上使用插件实现密码自动填充与同步

在 KeePass 客户端安装KeePassRPC 插件：

将其放入安装目录（.\KeePass\Plugins）文件夹下，退出软件，重启即可自动安装。

在浏览器客户端安装浏览器插件Kee，若无法科学上网，可能需要自行百度搜索 Kee 插件

安装完成后会跳出窗口提示授权，将 KeePass 客户端跳出的窗口中的红色授权码填入即可连接浏览器：

使用 Kee

再次使用浏览器填写密码是可以看到文本框会有 logo，Kee 会自动填写已保存的密码。如果第一次登陆，在登录后可以点击浏览器插件图标，找到 Save latest login，保存刚刚输入的密码。

密码管理器的重要作用之一就是生成高强度密码，可以用 KeePass 客户端来生成，也可以是 Kee 这个插件的一个生成密码功能生成。英文版的是Generate new password