Typedown
为Markdown添加语义层和验证能力的知识库工具。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Typedown。 它的用途是：为Markdown添加语义层和验证能力的知识库工具。 完整的 Skill 内容见：https://321skill.com/skills/typedown/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我在Typedown中定义一个‘项目需求’模型，包含标题、状态、负责人和截止日期字段，并设置状态变更的验证规则。”，它会生成包含Pydantic模型定义和对应Spec验证规则的Typedown代码块。接着，你可以创建具体的需求实体，所有链接和字段都会在VS Code中获得实时验证和导航。
介绍
Typedown旨在解决传统Markdown在大型知识库或文档项目中难以维护和扩展的问题。它通过在Markdown中引入基于Pydantic的模型定义、强类型实体、可验证的引用和业务规则（Spec），将松散的文本转化为结构化的、可验证的知识库。
使用时，开发者需在Markdown文件中嵌入特殊的代码块来定义数据模型（Model）、实例化数据（Entity）、创建实体间引用（Reference）以及编写验证规则（Spec）。Typedown的核心文件是.td扩展名，其完整功能（如实时验证、智能导航）需要通过其VS Code扩展来体验。
它非常适合需要维护大量结构化文档或内部知识库的团队，尤其是那些文档质量、数据一致性和内部链接完整性至关重要的场景，例如技术文档、产品需求库、内部流程手册等。
需要注意的是，Typedown的.td文件在GitHub等纯文本渲染环境中会显示为普通Markdown，其完整语义功能依赖IDE环境。因此，它更适合作为团队内部协作和知识管理的工具，而非面向公众的纯静态文档发布方案。
核心特点
Typedown的核心区别在于将Pydantic数据验证和强类型系统深度集成到Markdown中，实现了“渐进式形式化”，允许文档从松散文本平滑过渡到严格验证的知识图谱。其基于内容哈希的引用系统能自动追踪实体变更，有效解决传统Markdown链接易失效的问题。
注意事项
不适合仅需快速撰写和发布简单、一次性文档的个人用户或轻量级场景，其完整功能依赖VS Code等IDE环境。
常见问题
Typedown文件和普通Markdown有什么区别？
Typedown文件（.td）在普通Markdown基础上嵌入了可被验证的数据模型、实体实例和业务规则，需要通过VS Code扩展才能获得实时验证、智能跳转等完整功能。
Typedown能用于团队知识管理吗？
非常适合。它能确保团队知识库中的数据结构一致、引用链接可靠，并通过业务规则自动检查内容合规性，是构建可维护、高质量团队知识库的理想工具。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/typedown/raw/index.md 读取 Typedown 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/typedown/raw/index.md（查看排版版本）