Obsidian 文章命名规范
目的:统一 vault 中文章的命名方式,便于检索和归档
适用:_posts/目录下所有文章文件
最后更新:2026-05-07
一、目录结构概览
1.1 _posts 下的一级目录
_posts/
├── A_OS/ # 操作系统(Windows / Linux / Mac)
├── A_内功/ # 内功修炼(逆向 / 漏洞 / 机器学习)
├── B_Code/ # 代码实践(C / C++ / C# / Python / Go / Qt)
├── C_OpenSource/ # 开源项目研究
├── D_立志博览群书/ # 读书笔记
├── E_手册/ # 工具 / 写作 / 样式手册
├── G_安全/ # 安全研究
├── wiki/ # 系统性知识库(调试技术 / PE / 安全 / AI / 驱动)
└── 技术研究/ # 综合性技术研究(跨领域内容)
1.2 wiki/ 二级目录
wiki/
├── AI大模型/ # AI 大模型部署 / 应用 / 安全
├── PE/ # PE 文件结构
├── stellar/ # Stellar 主题
├── Windows驱动开发教程/ # 驱动学习系列
├── 安全/ # ASP.Net / ByPass / 提权
├── 弱密码/ # 各服务弱密码检测
├── 微信小程序/
└── 调试技术/ # WinDbg / 调试技术 / 崩溃分析
二、文件命名规则
2.1 核心格式
【类别】文章标题.md
两条铁律:
- 类别前缀必须用中文方括号
【 】 - 文章标题使用中文,简洁明了,不超过 20 字
2.2 wiki/ 与 _posts/ 的命名差异
| 目录 | 前缀风格 | 示例 |
|---|---|---|
_posts/(大多数) | 【类别】 纯前缀 | 【Dump】w3wp进程无响应分析.md |
_posts/wiki/ | 【调试技术】 / 【PE】 等领域前缀 | 【调试技术】Windbg基础命令.md |
wiki/目录下的文章使用领域主题前缀(【调试技术】、【PE】、【AI】),而非工具类前缀。
三、_posts/wiki/ 目录前缀参考表
3.1 wiki/调试技术/
前缀:【调试技术】 或 【Windbg插件】
| 文章类型 | 前缀 | 示例 |
|---|---|---|
| WinDbg 基础命令 / 技巧 | 【调试技术】 | 【调试技术】Windbg基础命令.md |
| 调试实战案例 | 【调试技术】 | 【调试技术】w3wp进程无响应分析.md |
| .NET 调试 | 【调试技术】 | 【调试技术】.NET 调试.md |
| TTD(Time Travel Debugging) | 【调试技术】 | 【调试技术】TTD.md |
| 双机调试 | 【调试技术】 | 【调试技术】双机调试-串口调试.md |
| Dump 文件生成 | 【调试技术】 | 【调试技术】手动创建蓝屏Dump.md |
| WinDbg 插件 | 【Windbg插件】 | 【Windbg插件】SDbgExt.md |
3.2 wiki/ 其他目录前缀
| 目录 | 前缀 | 示例 |
|---|---|---|
| PE/ | 【PE】 | 【PE】PE文件结构1.md |
| AI大模型/ | 【AI】 或 【AI大模型】 | 【AI】IDA-MCP.md |
| 样本分析专列/ | 【样本分析】 | 【样本分析】DLL劫持.md |
| Windows驱动开发教程/ | 【驱动学习】 | 【驱动学习】HelloWorld驱动与安装.md |
| 安全/ | 【ASP.Net】 / 【ByPass】 / 【网安】 / 【提权】 | 【网安】DCSYNC攻击.md |
| 弱密码/ | 【弱密码】 或 【弱口令】 | 【弱密码】MySQL8弱密码.md |
四、_posts/(非 wiki)目录前缀参考表
4.1 按技术领域
| 前缀 | 适用场景 | 示例 |
|---|---|---|
【WinDbg】 | WinDbg / 调试分析 | 【WinDbg】基础命令.md |
【Dump】 | Dump 文件分析 | 【Dump】xxx.md |
【内存泄漏】 | 内存泄漏问题 | 【内存泄漏】WinDbg定位分析.md |
【驱动】 | Windows 驱动 | 【驱动】签名绕过.md |
【Hook】 | Hook / 注入 | 【Hook】Detours使用.md |
【IPC】 | 进程间通信 | 【IPC】命名管道.md |
【漏洞】 | 漏洞分析 | 【漏洞】反序列化.md |
【逆向】 | 逆向工程 | 【逆向】PE结构.md |
【Yara】 | Yara 规则 | 【Yara】入门.md |
【CVE-YYYY-XXXXX】 | 具体 CVE 漏洞 | 【CVE-2021-26855】RCE漏洞.md |
4.2 按编程语言
| 前缀 | 语言 | 示例 |
|---|---|---|
【C】 | C 语言 | 【C】HexToByte.md |
【CPP】 | C++ | 【CPP】Lambda表达式.md |
【Net】 | .NET / C# | 【Net】JIT分析.md |
【Python】 | Python | 【Python】GUI界面.md |
【Qt】 | Qt 框架 | 【Qt】常用代码.md |
【GO】 | Go 语言 | 【GO】wails经验.md |
【Shell】 | Shell 脚本 | 【Shell】常用脚本.md |
【汇编】 | 汇编 | 【汇编】JCC.md |
4.3 按操作系统
| 前缀 | OS | 示例 |
|---|---|---|
【Linux】 | Linux | 【Linux】常用命令.md |
【Windows】 | Windows | 【Windows】导读.md |
【Mac】 | macOS | 【Mac】Xcode.md |
【Docker】 | 容器 | 【Docker】容器调试.md |
4.4 按文档类型
| 前缀 | 文档类型 | 示例 |
|---|---|---|
【原理剖析】 | 系统原理 / 源码分析 | 【原理剖析】1-操作系统概述.md |
【实战】 | 实操案例 | 【实战】内网横移.md |
【环境搭建】 | 环境配置 | 【环境搭建】IIS.md |
【索引】 | 索引 / 导航 | 【POC】POC索引.md |
【导读】 | 入门指南 | 【逆向学习】.md |
4.5 特殊前缀
| 前缀 | 用途 | 示例 |
|---|---|---|
【域渗透】 | Active Directory 渗透 | 【域渗透】DCSync.md |
【提权】 | 提权技术 | 【提权】令牌窃取.md |
【SQL注入】 | SQL 注入 | 【SQL注入】防御导读.md |
【POC】 | 漏洞验证代码 | 【POC】CVE-XXXX.md |
【ML】 | 机器学习 | 【ML】逻辑回归.md |
【手册】 | 工具 / 写作手册 | 【手册】写作样式.md |
五、特殊情况处理
5.1 系列文章
系列文章在标题中加序号:
【原理剖析】1-操作系统概述.md
【原理剖析】2-Linux内核及进程介绍.md
【原理剖析】a-Linux 内存管理.md ← 字母序号(接数字序号之后)
5.2 多标签情况
选择最能代表文章核心主题的标签作为前缀:
同一篇文章可能涉及多个领域,优先选择最具体的标签。
| 文章内容 | 选择前缀 | 说明 |
|---|---|---|
| 用 WinDbg 分析内存泄漏 | 【内存泄漏】 | 内存问题是核心,调试是手段 |
| 用 WinDbg 分析 Dump | 【调试技术】(wiki)或 【Dump】 | Dump 分析是核心,wiki 有专项目录 |
| 调试 PHP 扩展 | 【PHP】 | 语言是第一标签 |
| WinDbg 内核调试 | 【调试技术】 | winiki 有专项目录 |
5.3 目录选择决策树
文章涉及调试/内核分析?
└── 是 → wiki/调试技术/【调试技术】xxx.md
└── 否 ↓
文章涉及 PE 结构/逆向?
└── 是 → wiki/PE/【PE】xxx.md
└── 否 ↓
文章涉及 AI 大模型?
└── 是 → wiki/AI大模型/【AI】xxx.md
└── 否 ↓
属于代码实践类?
└── 是 → B_Code/【语言】xxx.md
└── 否 ↓
属于开源项目研究?
└── 是 → C_OpenSource/【项目】xxx.md
└── 否 ↓
综合跨领域研究 → 技术研究/【类别】xxx.md
工具/写作手册 → E_手册/【手册】xxx.md
六、Obsidian YAML 规范
6.1 wiki/ 目录文章
---
title: 【调试技术】文章标题
date: YYYY-MM-DD
tags:
- 调试技术
- 调试工具/WinDbg ← 分类子路径格式
- IIS/w3wp
categories:
- wiki ← 固定为 wiki
- 调试技术 ← 二级目录名
aliases:
- 别名(可选)
stage: 初稿 / 已完成
publish: false
wiki: slug-name ← 自定义字段,用于 wiki 导航
description: 一句话描述(可选)
---
> 概述:一句话描述文章内容6.2 _posts/ 其他目录文章
---
title: 【类别】文章标题
date: YYYY-MM-DD
tags:
- 技术标签1
- 技术标签2
aliases:
- 别名(可选)
stage: 初稿 / 已完成
publish: false
description: 一句话描述(可选)
---七、快速参考清单
文件命名:
- 类别前缀是否在参考表中?若是 → 直接使用
- 类别前缀不在参考表中?→ 新建并更新本文档
- 文章标题是否用中文?
- 是否超过 20 字?
- 是否包含
【】包裹的类别前缀?
目录选择:
- 是否为调试/内核类 → wiki/调试技术/
- 是否为 PE/逆向类 → wiki/PE/
- 是否为 AI 大模型类 → wiki/AI大模型/
- 上述都不符合 → 按技术领域归入对应目录
八、相关文档
由 M-Claw 🐙 整理 · 2026-05-07 · 首次创建