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

两条铁律

  1. 类别前缀必须用中文方括号 【 】
  2. 文章标题使用中文,简洁明了,不超过 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 · 首次创建