Markdown

本文介绍在 PaperMod 博客中撰写文章的注意事项。 文章页面字段-必填项 每篇文章开头的 front matter 必须包含以下字段： --- title: "文章标题" # 必填：文章标题 date: 2026-03-16 # 必填：发布日期 --- 文章页面字段-常用可选项 --- # ===== 基础信息 ===== title: "文章标题" # 必填：文章标题 date: 2026-03-16 # 必填：发布日期（YYYY-MM-DD） lastmod: 2026-03-17 # 最后修改日期 description: "文章简介" # 文章描述，用于 SEO 和社交媒体分享 author: "作者名" # 作者名，覆盖默认设置 keywords: ["关键词1", "关键词2"] # SEO 关键词 # ===== 分类与标签 ===== tags: ["标签1", "标签2"] # 标签，细粒度分类，可多个 categories: ["分类名"] # 分类，粗粒度分类，通常一个 series: ["系列名"] # 系列文章，用于关联多篇相关文章 # ===== 发布状态 ===== draft: false # false = 发布，true = 草稿（不显示） publishDate: 2026-03-16 # 发布日期（可用于定时发布） expiryDate: 2026-12-31 # 过期日期，过期后文章不显示 # ===== 排序与置顶 ===== weight: 1 # 排序权重，数字越小越靠前（用于置顶） pinned: true # PaperMod 特有：置顶文章 # ===== 封面图片 ===== cover: image: "images/cover.jpg" # 封面图片路径（相对 static 目录） alt: "图片描述" # 图片 alt 文本（无障碍访问） caption: "图片说明" # 图片下方说明文字 relative: false # true = 相对于文章目录，false = 相对于 static # ===== 功能开关（覆盖全局设置）===== ShowToc: true # 是否显示目录 TocOpen: true # 目录是否默认展开 ShowReadingTime: true # 是否显示阅读时间 ShowShareButtons: true # 是否显示分享按钮 ShowBreadCrumbs: true # 是否显示面包屑导航 ShowPostNavLinks: true # 是否显示上一篇/下一篇导航 ShowCodeCopyButtons: true # 是否显示代码复制按钮 ShowWordCount: true # 是否显示字数 comments: false # 是否启用评论 # ===== 其他设置 ===== slug: "custom-url" # 自定义 URL 别名（默认用文件名） url: "custom-path/" # 自定义完整 URL 路径 type: "posts" # 内容类型（默认根据目录自动判断） layout: "custom-layout" # 自定义布局模板 --- 标签与分类 标签（tags）和分类（categories）的区别： ...

VS Code 的强大之处不在于编辑器本身，而在于其庞大的插件生态。通过深度分析当前的插件配置，我们可以看到一套集成了 AI 编程辅助、深度 Markdown 写作、多语言开发 以及 高效运维 的全能型工作站。 以下是对这套配置的深度拆解，旨在帮助大家理解每个插件的核心价值，并优化自己的开发流。 一、 AI 编程助手：迈向“自动驾驶”开发 AI 插件已经从简单的代码补全演变为能够执行任务的智能 Agent。 1. GitHub Copilot Chat (github.copilot-chat) 核心功能：在 IDE 内直接与 AI 对话，解释代码、生成单元测试或修复 Bug。 独特优势：与 GitHub 生态深度集成，上下文感知能力极强。 实际应用：当你面对一段陈旧且没有文档的复杂函数时，直接右键让它“解释这段代码”。 用户价值：消除“冷启动”困难，极大提升理解新代码库的速度。 2. 通义灵码 (alibaba-cloud.tongyi-lingma) 核心功能：阿里巴巴推出的 AI 助手，支持代码补全、单元测试生成。 独特优势：针对中文语义优化，国内访问无需特殊网络环境。 实际应用：在网络不稳时作为 Copilot 的稳健替代。 用户价值：提升本土化开发体验，降低 AI 工具的使用成本。 3. Roo-Cline (rooveterinaryinc.roo-cline) & Claude-dev 核心功能：基于 Agent 架构，能自主执行文件读写、运行终端命令。 独特优势：不仅“说”，而且“做”。它可以根据一句话需求，自动修改多个文件并验证结果。 实际应用：自动化重构大型模块，或从零构建项目骨架。 用户价值：将开发者从繁琐的重复劳动中解放出来。 二、 Markdown 文档全家桶：打造专业写作工作站 这是一套将 VS Code 变成“最强 Markdown 编辑器”的组合。 1. Markdown All in One (yzhang.markdown-all-in-one) 核心功能：快捷键支持、自动补全、目录生成。 独特优势：功能最全面的基础插件，几乎是 Markdown 写作的必装。 价值：提供顺滑的写作体验。 2. Markdown Preview Enhanced (shd101wyy.markdown-preview-enhanced) 核心功能：支持 Mermaid 图表、导入外部文件、数学公式预览。 独特优势：预览效果极其精美，且支持多种渲染引擎。 应用场景：编写技术文档、绘制流程图、撰写学术笔记。 价值：一站式解决复杂文档的渲染需求。 3. VS Code Front Matter (eliostruyf.vscode-front-matter) 核心功能：可视化的博客元数据（YAML）管理。 独特优势：专为静态博客设计，提供类似 CMS 的管理面板。 应用场景：管理 Hugo, Hexo 或 Jekyll 博客。 价值：让文章发布和管理变得井然有序。 4. 辅助插件 Paste Image：截图直接粘贴为 Markdown 链接。 Markdown PDF：将文档完美导出为 PDF 格式。 Auto TOC：自动维护文档目录。 三、 语言支持与专业调试：工业级开发环境 1. Python & Jupyter 生态 核心插件：ms-python.python, ms-toolsai.jupyter 优势：官方支持，功能涵盖从代码补全到交互式数据分析的所有环节。 价值：让 VS Code 拥有不输于 PyCharm 的开发体验。 2. C# / .NET 核心 核心插件：ms-dotnettools.csdevkit 价值：跨平台 .NET 开发的核心，支持强大的重构和调试。 3. Lua 语言强化 核心插件：sumneko.lua 价值：目前市面上最强大的 Lua 语法分析插件，游戏开发者的福音。 四、 代码质量与界面美化 1. 质量卫士 Prettier：强制统一代码风格。 Code Spell Checker：检查英文拼写，避免变量名写错。 Todo Tree：在侧边栏集中管理代码中的 TODO 标记。 2. UI 增强 Indent Rainbow：用彩虹色区分缩进层级，逻辑结构一目了然。 Material Icon Theme：为不同的文件类型匹配精美图标。 五、 总结性对比建议与使用心得 1. 插件对比建议 关于 AI 助手：目前建议采用“1+1”模式：Copilot 用于高频率的代码自动补全，Roo-Cline 用于执行具体的重构任务或处理复杂指令。 关于 Markdown：如果只做简单记录，Markdown All in One 足矣；如果要出书或写深度技术稿件，Markdown Preview Enhanced 必不可少。 2. 使用心得 按需启用：90 多个插件虽然功能强大，但会占用内存。建议使用 VS Code 的 “Disable (Workspace)” 功能，在不同的项目（如：纯写作项目 vs 纯代码项目）中禁用无关插件。 同步与备份：建议开启 VS Code 的 Settings Sync，确保在不同电脑上都能获得一致的强大体验。 附录：当前环境下安装的完整插件列表 以下是系统检测到的所有插件（共 97 项）： ...