
作者:HOS(安全风信子) 日期:2026-01-27 来源平台:GitHub 摘要: 本文深入探讨了 Prompt 工程中的格式选择问题,从简单的「JSON vs Markdown」对比上升到「理性 × 感性」的系统设计高度。通过分析两种格式的本质差异、适用场景以及混合结构的优势,本文提出了「对人用 Markdown,对系统用 JSON,对高级系统用混合结构」的核心观点,并通过人类认知系统的类比,论证了混合结构是 Prompt 工程的未来方向。
本节为什么值得重点关注:理解 Prompt Engineering 的发展背景和当前趋势,是掌握其核心问题和解决方案的基础。从简单的提示词到复杂的系统设计,Prompt 的角色正在发生深刻变化,这直接影响到我们对格式选择的认知。
Prompt Engineering 已经从最初的「如何写好一句话」发展成为一门复杂的工程学科。这一演变可以分为三个阶段:
第一阶段:自由文本时代
第二阶段:结构化模板时代
第三阶段:系统集成时代
在当前的技术生态中,Prompt Engineering 面临着以下几个热点挑战:
在这些挑战的背景下,一个核心问题逐渐凸显:
❓ Prompt 是写给模型看的?还是写给系统用的?
这看似是一个简单的格式选择问题,但实际上涉及到 Prompt Engineering 的本质:
而更深一层的问题是:
❓ 我们是在设计一句话,还是在设计一个「认知接口」?
这个问题将我们的思考从单纯的格式选择提升到了系统设计的高度。在接下来的章节中,我们将深入探讨这个问题,并提出一种全新的视角来理解 Prompt 工程。
本节为什么值得重点关注:本节提出了三个全新的视角来重新审视 Prompt 格式选择问题,帮助读者突破传统思维的局限,从更本质的层面理解 JSON 与 Markdown 两种格式的差异及其融合的必要性。
传统观点将 Prompt 格式选择视为一个简单的技术偏好问题:
但这种二元对立的思维方式忽略了一个重要事实:在现代 AI 系统中,Prompt 已经成为系统架构的一部分,它需要同时服务于两个不同的「用户」:
因此,Prompt 格式的选择本质上是一个系统设计问题,需要在「可读性」和「可执行性」之间寻找平衡。
这是理解高级 Prompt 设计的关键类比。人类本身就是一个完美的「JSON + Markdown 混合系统」:
人类认知层 | 类比 Prompt 结构 | 功能 |
|---|---|---|
理性思维(逻辑、规则、结构) | JSON | 提供结构化的思考框架,确保逻辑一致性 |
感性思维(语气、语境、联想) | Markdown | 提供丰富的语义表达,激发创意和情感 |
决策行为 | JSON + Markdown 协同结果 | 综合理性分析和感性判断,做出合理决策 |
当我们说话时:
这种类比告诉我们:一个真正高级的 AI 系统 Prompt 结构,必然模拟人类的这种双层结构。
基于上述认知,我们提出了混合结构的分层设计理念:
通过以上三个新要素的分析,我们可以强化本文的核心观点:
低阶是选格式,高阶是做融合 对人用 Markdown,对系统用 JSON,对高级系统用 JSON + Markdown 混合结构
这一观点不仅解决了格式选择的问题,更重要的是,它为 Prompt 工程提供了一种全新的系统设计思路,将 Prompt 从简单的文本提升为复杂的「认知接口」。
本节为什么值得重点关注:深入理解 Markdown Prompt、JSON Prompt 和混合结构的技术实现细节,是掌握其优势劣势和适用场景的关键。通过技术拆解,我们可以看到不同格式的底层工作原理,以及混合结构如何实现「理性 × 感性」的统一。
Markdown Prompt 是一种以 Markdown 语法为基础的结构化提示词格式,其典型结构如下:
# 角色
你是一个资深架构师
# 任务
分析以下系统设计的可扩展性
# 输出格式
- 使用要点列表
- 给出优化建议技术实现要点:
# 标记不同的语义区块- 或 1. 标记要点** 标记重要内容LLM 对 Markdown 结构的理解主要基于以下机制:
示例:当模型看到 # 角色 标题时,会自动将其下方的内容理解为对自身角色的定义,这比单纯的文本提示更加有效。
然而,从工程实现的角度看,Markdown Prompt 面临着以下挑战:
JSON Prompt 是一种以 JSON 数据结构为基础的结构化提示词格式,其典型结构如下:
{
"role": "senior_architect",
"task": "analyze_system_scalability",
"constraints": [
"use_bullet_points",
"include_optimization_suggestions"
],
"output_format": "structured_markdown"
}技术实现要点:
"key": "value" 结构存储信息LLM 对 JSON Prompt 的理解主要基于以下机制:
示例:当模型看到 "role": "senior_architect" 时,会明确理解自己的角色定位,而不会被其他无关信息干扰。
从工程实现的角度看,JSON Prompt 具有以下优势:
混合结构是一种将 JSON 和 Markdown 结合使用的 Prompt 格式,其典型结构如下:
{
"system_role": "architecture_expert",
"task_type": "analysis",
"constraints": {
"format": "bullet_points",
"must_include": ["risks", "optimizations"]
},
"instruction_md": "# 分析目标\n请评估系统扩展性,并给出可落地优化建议。\n\n注意从成本、性能、可维护性三个角度展开。"
}技术实现要点:
_md 后缀的字段存储 Markdown 格式的语义内容_md 后缀混合结构的工作原理可以分为以下几个步骤:

图表解读:
结论:混合结构结合了 Markdown 的语境理解优势和 JSON 的系统解析优势,能够产生既具有创意又符合结构要求的输出。

图表解读:
结论:混合结构 Prompt 模拟了人类认知系统的双层结构,这是其能够同时满足理解和执行需求的根本原因。
场景:创作型任务 - 撰写产品文案
# 角色
你是一位资深产品文案撰写专家,擅长撰写吸引人的产品描述。
# 任务
为一款智能手表撰写产品文案,突出其健康监测功能。
# 产品信息
- 品牌:FitPro
- 型号:X1
- 核心功能:心率监测、血氧监测、睡眠分析、运动追踪
- 特色:续航 7 天,防水等级 50 米
# 输出要求
- 风格:专业但不失亲和力
- 结构:标题 + 副标题 + 核心卖点(3-4 点) + 结语
- 长度:约 300 字适用场景:创作型任务,如文案写作、故事创作、角色扮演等需要丰富语义表达的场景。
场景:结构化任务 - 数据处理
{
"role": "data_processing_agent",
"task": "extract_key_information",
"input_data": "2023年Q3,公司营收达到1.2亿美元,同比增长25%,其中北美市场贡献了60%的收入,欧洲市场增长最快,达到了40%的增长率。",
"output_format": {
"type": "json",
"fields": [
"period",
"revenue",
"growth_rate",
"north_america_contribution",
"europe_growth_rate"
]
},
"constraints": [
"extract_exact_values",
"use_numeric_formats",
"maintain_original_units"
]
}适用场景:结构化任务,如数据提取、信息汇总、格式转换等需要严格结构输出的场景。
场景:复杂任务 - 系统架构分析
{
"system_role": "software_architect",
"task_type": "architecture_analysis",
"analysis_target": "e-commerce_platform",
"constraints": {
"format": "detailed_report",
"sections": [
"current_architecture",
"scalability_analysis",
"performance_evaluation",
"security_assessment",
"optimization_recommendations"
],
"depth": "technical_detail"
},
"instruction_md": "# 分析目标\n请对电商平台系统架构进行全面分析,并提供详细的优化建议。\n\n# 分析要求\n1. **当前架构评估**:详细描述系统的组件结构、数据流和依赖关系\n2. **可扩展性分析**:评估系统在用户量和数据量增长时的表现\n3. **性能评估**:分析系统的响应时间、吞吐量和资源利用率\n4. **安全性评估**:识别潜在的安全漏洞和风险\n5. **优化建议**:提供具体、可落地的架构优化方案\n\n# 输出格式\n- 使用结构化报告格式\n- 每个部分使用清晰的标题\n- 对技术细节提供具体数据支持\n- 优化建议需包含实施难度和预期效果分析",
"context_md": "# 系统背景\n- 系统规模:日均活跃用户 100 万+\n- 技术栈:Java + Spring Boot + MySQL + Redis + Kafka\n- 部署方式:容器化部署在云平台\n- 现状:系统在促销活动期间偶尔出现性能瓶颈"
}适用场景:复杂任务,如系统分析、方案设计、多步骤任务等需要同时满足理解和执行需求的场景。
本节为什么值得重点关注:通过与主流 Prompt 格式方案的深度对比,我们可以更清晰地理解 Markdown Prompt、JSON Prompt 和混合结构的优势劣势,以及它们在不同场景下的适用性。这有助于我们在实际项目中做出更合理的选择。
维度 | Markdown Prompt | JSON Prompt | 混合结构 |
|---|---|---|---|
可读性 | ⭐⭐⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐⭐ |
结构稳定性 | ⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
语义表达能力 | ⭐⭐⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐⭐⭐ |
易于解析 | ⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
参数传递能力 | ⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
版本管理便利性 | ⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
创作任务适用性 | ⭐⭐⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐⭐⭐ |
自动化系统适用性 | ⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
学习曲线 | ⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ |
实施复杂度 | ⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ |
场景类型 | 推荐格式 | 原因 |
|---|---|---|
小说生成 | Markdown | 语义表达丰富,有利于创作灵感 |
世界观设定 | Markdown | 结构灵活,便于组织复杂信息 |
剧情设计 | Markdown | 语气控制自然,有利于情感表达 |
角色扮演 | Markdown | 角色定位清晰,互动性强 |
文案写作 | Markdown | 格式友好,易于调整风格 |
数据提取 | JSON | 结构稳定,便于与数据系统集成 |
信息汇总 | JSON | 字段固定,输出格式可预测 |
格式转换 | JSON | 规则明确,转换逻辑清晰 |
工作流节点 | 混合结构 | 既便于系统调用,又保证任务理解 |
Agent 系统指令 | 混合结构 | 既提供角色定义,又确保行为约束 |
系统架构分析 | 混合结构 | 既需要专业知识表达,又需要结构化输出 |
多步骤任务 | 混合结构 | 既保持任务连贯性,又确保每步执行准确 |
实践维度 | Markdown Prompt | JSON Prompt | 混合结构 |
|---|---|---|---|
开发效率 | 高(易于编写) | 中(需要严格格式) | 中高(兼顾两者) |
调试难度 | 中(靠人工阅读) | 低(靠字段检查) | 低(既有结构又有语义) |
系统集成 | 低(需要额外解析) | 高(直接集成) | 高(最佳集成体验) |
维护成本 | 高(结构不稳定) | 低(结构固定) | 低(结构稳定且语义清晰) |
扩展性 | 中(靠人工调整) | 高(靠字段扩展) | 高(结构和语义均可扩展) |
团队协作 | 高(非技术人员易参与) | 中(技术人员为主) | 高(技术和非技术人员各司其职) |
性能开销 | 低(解析简单) | 低(解析高效) | 中(需要解析两种格式) |
错误处理 | 中(语法错误不易发现) | 高(JSON 解析严格) | 高(JSON 部分严格,Markdown 部分灵活) |
通过以上三个维度的对比,我们可以得出以下结论:
核心洞察:混合结构并不是 Markdown 和 JSON 的简单组合,而是一种全新的系统设计思路,它通过分层架构同时满足了感性表达和理性执行的需求,代表了 Prompt 工程的未来发展方向。
本节为什么值得重点关注:理解 Prompt 格式选择的实际工程意义和潜在风险,是将理论转化为实践的关键。在实际项目中,我们需要权衡各种因素,制定合理的 Prompt 设计策略,同时规避可能的风险。
Prompt 格式的选择直接影响到系统的架构设计:
Markdown 优先的系统
JSON 优先的系统
混合结构的系统
不同的 Prompt 格式也会影响开发流程:
Markdown Prompt
JSON Prompt
混合结构
Prompt 格式的选择还会影响系统的运维管理:
Markdown Prompt
JSON Prompt
混合结构
针对上述风险,我们可以采取以下 mitigation 策略:
_md 后缀基于以上分析,我们提出以下工程实践建议:
核心原则:Prompt 格式的选择应该服务于系统的整体目标,而不是为了格式而格式。在实际项目中,我们需要根据具体需求、团队能力和系统架构等因素,综合考虑选择合适的 Prompt 格式策略。
本节为什么值得重点关注:展望 Prompt 工程的未来发展趋势,有助于我们提前布局,适应技术的快速变化,为未来的工程实践做好准备。从格式选择到系统设计,Prompt 工程正在经历深刻的变革,这将对整个 AI 行业产生深远影响。
未来,Prompt 格式可能会朝着更加标准化的方向发展:
行业标准的形成
Schema 定义的普及
类型系统的引入
Prompt 格式的处理也会变得越来越智能化:
自动生成与优化
自适应调整
个性化定制
未来的 Prompt 格式可能会更好地支持多模态信息:
多媒体嵌入
跨模态引用
统一表示
未来,Prompt Engineering 的工具链会变得更加完善:
IDE 集成
CI/CD 支持
监控平台
版本管理
随着实践的积累,Prompt 格式选择的最佳实践会逐渐形成:
场景化模板
行业特定格式
开源生态
Prompt Engineering 可能会成为一门正式的学科:
课程体系
认证体系
社区建设
基于当前的技术发展和行业趋势,我个人对 Prompt 工程的未来发展有以下预测:
Prompt 工程的未来发展将受到以下几个核心驱动力的影响:
核心洞察:Prompt 工程的未来不是简单的格式进化,而是从"格式选择"到"系统设计"的范式转变。它将成为 AI 系统架构的核心组成部分,影响整个 AI 行业的发展方向。
参考链接:
附录(Appendix):
字段类型 | 命名规则 | 示例 |
|---|---|---|
系统角色 | system_role | "system_role": "software_architect" |
任务类型 | task_type | "task_type": "architecture_analysis" |
约束条件 | constraints | "constraints": { "format": "bullet_points" } |
输出格式 | output_format | "output_format": "structured_report" |
Markdown 指令 | instruction_md | "instruction_md": "# 分析目标\n请评估系统扩展性..." |
Markdown 上下文 | context_md | "context_md": "# 系统背景\n- 系统规模:日均活跃用户 100 万+..." |
Markdown 风格指南 | style_guide_md | "style_guide_md": "# 写作风格\n- 专业但不失亲和力..." |
{
"system_role": "角色名称",
"task_type": "任务类型",
"constraints": {
"format": "输出格式",
"must_include": ["必须包含的内容"],
"avoid": ["避免的内容"]
},
"output_format": {
"type": "格式类型",
"fields": ["输出字段"]
},
"instruction_md": "# 指令标题\n指令内容",
"context_md": "# 上下文标题\n上下文内容",
"style_guide_md": "# 风格指南标题\n风格指南内容"
}{
"system_role": "customer_service_agent",
"task_type": "customer_support",
"constraints": {
"format": "natural_language",
"tone": "friendly_professional",
"response_time": "within_30_seconds"
},
"output_format": {
"type": "dialog",
"max_length": "200_words"
},
"instruction_md": "# 角色定位\n你是一位专业的客户服务代表,致力于为客户提供及时、准确、友好的帮助。\n\n# 服务准则\n1. **倾听理解**:认真倾听客户的问题,确保完全理解他们的需求\n2. **专业回应**:基于产品知识提供准确的信息和解决方案\n3. **友好态度**:保持礼貌、耐心和同理心\n4. **及时解决**:尽可能在一次对话中解决客户的问题\n5. **后续跟进**:对于无法立即解决的问题,承诺后续跟进并提供明确的时间预期\n\n# 处理流程\n1. 问候客户并确认问题\n2. 分析问题并提供解决方案\n3. 确认客户是否满意\n4. 礼貌结束对话",
"context_md": "# 产品信息\n- 产品名称:SmartHome 智能音箱\n- 主要功能:语音助手、音乐播放、智能家居控制\n- 常见问题:连接问题、语音识别问题、固件更新问题\n- 支持渠道:电话、邮件、在线聊天\n\n# 公司政策\n- 7 天无理由退货\n- 1 年硬件保修\n- 24/7 客户支持"
}{
"system_role": "data_analysis_node",
"task_type": "sales_data_analysis",
"constraints": {
"format": "structured_report",
"timeframe": "last_30_days",
"minimum_samples": "1000"
},
"output_format": {
"type": "json",
"fields": [
"total_sales",
"sales_by_region",
"top_products",
"sales_trend",
"recommendations"
]
},
"instruction_md": "# 分析目标\n请对过去 30 天的销售数据进行全面分析,并提供详细的销售报告。\n\n# 分析要求\n1. **销售概览**:计算总销售额、订单数量、平均订单金额\n2. **地区分析**:按地区统计销售额和增长率\n3. **产品分析**:识别 top 10 热销产品和表现最差的 5 个产品\n4. **趋势分析**:分析销售趋势,识别周期性模式\n5. **异常检测**:识别销售额异常波动的日期和原因\n6. **建议**:基于分析结果,提供至少 3 条具体的销售策略建议\n\n# 数据处理\n- 排除测试订单和退款订单\n- 处理缺失数据,使用合理的插值方法\n- 确保数据一致性和准确性",
"context_md": "# 数据来源\n- 销售数据库:MySQL 数据库,表名:sales_orders\n- 产品数据库:MongoDB 数据库,集合名:products\n- 地区信息:CSV 文件,路径:/data/regions.csv\n\n# 数据字段\n- 订单表:order_id, customer_id, product_id, quantity, price, order_date, region_id, status\n- 产品表:product_id, product_name, category, price, stock\n- 地区表:region_id, region_name, country, population"
}工具名称 | 类型 | 功能 | 适用场景 |
|---|---|---|---|
PromptBase | 市场 | Prompt 交易和分享 | 寻找优质 Prompt 模板 |
LangChain | 框架 | Prompt 管理和优化 | 构建基于 LLM 的应用 |
Dify | 平台 | 可视化 Prompt 开发 | 快速构建 AI 应用 |
Promptify | 工具 | Prompt 测试和优化 | 提高 Prompt 质量 |
Git | 版本控制 | Prompt 版本管理 | 团队协作和变更追踪 |
JSON Schema Validator | 工具 | JSON 结构验证 | 确保 JSON Prompt 格式正确 |
Markdown Lint | 工具 | Markdown 格式检查 | 确保 Markdown Prompt 格式规范 |
Mermaid Live Editor | 工具 | Mermaid 图表编辑 | 设计和测试 Mermaid 图表 |
关键词: Prompt Engineering, JSON Prompt, Markdown Prompt, 混合结构, 系统设计, 理性与感性, 大语言模型, Agent 系统