https://ysy.fan/tags/markdownlint/Recent content in Markdownlint on YSY的博客Hugo -- gohugo.iozh-cnTue, 10 Feb 2026 00:00:00 +0000https://ysy.fan/p/vscode-markdown-format-tips/Tue, 10 Feb 2026 00:00:00 +0000https://ysy.fan/p/vscode-markdown-format-tips/<h2 id="1-前言">1. 前言 </h2><p>在 VS Code 中编写 Markdown 时，常常会遇到各种格式问题：表格对不齐、列表缩进混乱、链接格式错误等。本文将介绍如何通过插件和配置来轻松解决这些问题，让你的 Markdown 写作更加高效。</p> <h2 id="2-安装插件-markdownlint">2. 安装插件 markdownlint </h2><h3 id="21-格式检查工具">2.1. 格式检查工具 </h3><p><strong>功能</strong>：</p> <ul> <li>实时检查 Markdown 格式</li> <li>自动修复常见问题</li> <li>保持文档规范统一</li> </ul> <p><strong>常见提示</strong>：</p> <table> <thead> <tr> <th>规则</th> <th>说明</th> <th>解决</th> </tr> </thead> <tbody> <tr> <td>MD001</td> <td>标题层级不连续</td> <td>不要从 # 直接跳到 ###</td> </tr> <tr> <td>MD009</td> <td>行尾有多余空格</td> <td>删除行尾空格</td> </tr> <tr> <td>MD012</td> <td>连续空行超过一行</td> <td>删除多余空行</td> </tr> <tr> <td>MD013</td> <td>行长度超过限制</td> <td>换行或调整配置</td> </tr> <tr> <td>MD022</td> <td>标题前后需要空行</td> <td>添加空行</td> </tr> <tr> <td>MD032</td> <td>列表前后需要空行</td> <td>添加空行</td> </tr> </tbody> </table> <h3 id="22-使用方法">2.2. 使用方法 </h3><ol> <li>在拓展商店搜索并安装 markdownlint</li> </ol> <p><a href="images/2026-02-10-23-18-56.png" target="_blank"> <img src="images/2026-02-10-23-18-56.png" alt="image" style="max-width: 100%; width: 1000px;"/> </a></p> <ol start="2"> <li>打开设置 (json)</li> </ol> <p><a href="images/2026-02-10-23-21-47.png" target="_blank"> <img src="images/2026-02-10-23-21-47.png" alt="image" style="max-width: 100%; width: 500px;"/> </a></p> <p><a href="images/2026-02-10-23-22-18.png" target="_blank"> <img src="images/2026-02-10-23-22-18.png" alt="image" style="max-width: 100%; width: 1000px;"/> </a></p> <ol start="3"> <li>在设置中输入</li> </ol> <div class="highlight"><div class="chroma"> <table class="lntable"><tr><td class="lntd"> <pre tabindex="0" class="chroma"><code><span class="lnt">1 </span><span class="lnt">2 </span><span class="lnt">3 </span><span class="lnt">4 </span></code></pre></td> <td class="lntd"> <pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"><span class="line"><span class="cl"> &#34;editor.codeActionsOnSave&#34;: { </span></span><span class="line"><span class="cl"> &#34;source.fixAll.markdownlint&#34;: &#34;explicit&#34;, </span></span><span class="line"><span class="cl"> }, </span></span><span class="line"><span class="cl"> &#34;editor.formatOnSave&#34;: true, </span></span></code></pre></td></tr></table> </div> </div><br> <a href="images/2026-02-10-23-23-38.png" target="_blank"> <img src="images/2026-02-10-23-23-38.png" alt="image" style="max-width: 100%; width: 1000px;"/> </a> <h2 id="3-总结">3. 总结 </h2><p>之后只要 Ctrl + S 保存文件，就会自动修正 Markdown 格式</p> <hr> <p>最后更新：2026-02-10</p>