Markdown格式在提示词中的应用技巧上一篇文章我们讲了用分隔符组织提示词。今天我们来深入一个更具体的话题——如何用Markdown格式来写提示词。Markdown不仅是一种排版语法在提示词工程中它是一套信息层级编码系统——通过标题、列表、代码块、粗体等元素你可以精确地告诉AI这段内容是什么级别、“那段内容是代码还是文本”、“这个信息比那个信息更重要”。掌握Markdown在提示词中的应用你的提示词信息传递效率能提升一个台阶。一、Markdown在提示词中的特殊价值1.1 不只是排版好看很多人以为在提示词中使用Markdown只是为了让提示词看起来更整洁。这个理解太表面了。Markdown在提示词中的核心价值不是美观而是语义信号。AI的训练数据中包含海量的Markdown格式文档GitHub上的README、技术博客、文档网站等。这意味着AI对Markdown的语义有深刻的理解——它知道# 标题是一级主题知道**粗体**是强调内容知道代码块中的内容应该被当作代码而非自然语言处理。当你使用Markdown格式时你利用的是AI在训练中建立起来的格式-语义映射关系。这比用普通文本分隔符传达信息要高效得多。1.2 Markdown的语义信号系统Markdown的每个语法元素都向AI发送一个特定的语义信号Markdown元素向AI传达的语义信号# 标题“这是最高层级的主要话题”## 二级标题“这是主话题下的一个子话题”**粗体**“这是需要特别注意的重要内容”*斜体*“这是术语或需要区分的特殊词汇”- 列表项“这是并列的独立条目”1. 有序列表“这些条目有先后顺序” 代码块 “这是代码/数据不要当作自然语言处理” 行内代码 “这是技术术语、变量名或命令” 引用“这是引用的内容或示例”--- 水平线“这是一个话题分隔前后是不同的内容板块” 理解了这个语义信号系统你就能更精确地使用Markdown来编写AI对你提示词的理解方式。二、标题层级的使用策略2.1 用标题构建信息层级 标题是Markdown中最强的语义信号。一个#和##的差别在AI的理解中是主题和子主题的差别。标题层级的最佳实践# 一级标题 → 用于提示词的最顶层板块如角色设定、任务要求 ## 二级标题 → 用于板块内的主要分类如内容要求、格式要求 ### 三级标题 → 用于分类内的细分项如字数要求、风格要求 #### 四级标题 → 尽量少用层级太深反而让结构复杂完整示例# 任务描述 分析Q2用户增长数据并生成报告。 # 角色设定 你是一位数据分析师擅长从数据中提取商业洞察。 # 分析要求 ## 内容维度 ### 用户增长 - 新增用户趋势分析 - 渠道来源分析 ### 用户留存 - 次日/7日/30日留存率 - 留存率变化的原因分析 ### 收入分析 - ARPU/ARPPU变化趋势 - 付费转化率分析 ## 格式要求 ### 报告结构 1. 摘要 2. 核心指标概览 3. 详细分析 4. 建议 ### 字数限制 - 总报告1500字以内 - 摘要200字以内 # 参考示例 [示例内容] # 数据输入 [数据]2.2 标题层级的数量控制⚠️一个提示词中的标题层级不要超过3级。超过3级后结构变得复杂AI反而可能迷失在层级中。✅ 最多3级标题 # 大板块 ## 子板块 ### 细项 到此为止 ❌ 过度嵌套 # 大板块 ## 子板块 ### 细项 #### 更细的项 ##### 太细了 ###### 失去意义了 如果发现需要4级以上的标题说明你的信息组织结构有问题——应该考虑展平层级或者将一些内容移到列表或段落中。2.3 标题的命名原则标题内容应该是描述性的而非结构性的。✅ 描述性标题AI能理解板块的内容性质 # 角色设定 # 数据分析要求 # 输出格式规范 # 参考示例 ❌ 结构性标题AI不知道每个板块是干什么的 # 第一部分 # 第二部分 # 第三部分三、列表的使用技巧3.1 有序列表 vs 无序列表 这个选择直接影响AI对这些条目之间的关系的理解。使用有序列表1. 2. 3.的场景步骤、流程、先后顺序明确的条目优先级排序从高到低时间顺序从前到后分析步骤 1. 先查看数据整体趋势 2. 再定位异常时间点 3. 然后分析异常维度的交叉影响 4. 最后形成结论和建议使用无序列表- * 的场景并列的要求、规则、特征无先后顺序的选项或要素清单式的检查要点分析中需关注的因素 - 季节性波动 - 竞品动态影响 - 产品功能变更 - 市场环境变化3.2 嵌套列表的深度控制⚠️嵌套列表不要超过3层。超过3层的嵌套在AI的理解中可能产生混淆。✅ 最多3层嵌套 - 数据分析 - 用户维度 1. 新增用户 2. 活跃用户 3. 流失用户 - 收入维度 1. 总收入 2. 人均收入 ❌ 过度嵌套 - 第一层 - 第二层 - 第三层 - 第四层开始失去结构意义 - 第五层AI可能无法准确理解层级关系3.3 列表项的一致性 同一层级的列表项应该是同类内容。不要在同一个列表中混合不同类型的条目。❌ 混合类型 分析要求 - 查看用户增长趋势行为 - 收入变化数据项 - 建议优化产品功能结论/建议 ✅ 同类一致 分析内容 - 用户增长趋势 - 收入变化分析 - 留存率变化分析 - 渠道效果对比 分析步骤 - 第一步数据概览 - 第二步异常定位 - 第三步原因分析 - 第四步形成建议四、代码块的正确使用4.1 什么时候用代码块 代码块告诉AI“这部分内容请按照代码/数据/结构化文本的方式理解不要当作自然语言指令。”应该放在代码块中的内容实际的代码片段JSON/XML/YAML等结构化数据示例输出格式提示词中的示例部分特别是格式示范不应该被AI当作指令解读的纯展示性内容✅ 用代码块包裹示例输出格式 请按照以下格式输出 json { analysis: 分析内容, score: 85, recommendations: [建议1, 建议2] }❌ 不用代码块AI可能混淆请按照以下格式输出{“analysis”: “分析内容”,“score”: 85,“recommendations”: [“建议1”, “建议2”]}### 4.2 代码块的语言标注 在代码块的开头标注语言类型能进一步帮助AI理解内容的性质。json → AI知道这是JSON数据会以数据格式理解 sql → AI知道这是SQL查询会以数据库查询语义理解 → 不加标注AI需要自行判断标注语言类型是一个零成本但有效的习惯建议养成。4.3 行内代码的妙用 行内代码用反引号包裹用于标记这不是普通文字而是技术术语、变量名、命令或特定值。✅ 使用行内代码的场景 请用 pandas.DataFrame.groupby() 进行分组聚合。 将 status 字段的值设置为 active 或 inactive。 运行 npm install 安装依赖。 不需要用行内代码的场景 今天天气很好适合出去散步。 请仔细分析用户反馈中的情感倾向。五、强调与引用5.1 粗体和斜体的信号强度 在提示词中粗体和斜体不仅是排版更是重要性信号。**粗体** 高优先级信号“这个信息特别重要请特别注意”*斜体* 低优先级信号“这是一个术语或特殊表达请注意区分”***粗斜体*** 最高优先级信号慎用用多了就没效果了⚠️使用原则一篇提示词中粗体的使用应该控制在5处以内。如果到处都是粗体那就没有重点了——AI会对所有粗体内容一视同仁地重视等于没有突出任何东西。✅ 适度使用粗体突出最关键的要求 请分析以下数据。**最重要的要求所有结论必须有数据支撑不能凭感觉推测。** 另外请注意输出格式要求。 ❌ 过度使用粗体失去了突出重点的作用 请**分析**以下**数据**。**最重要**的要求**所有结论**必须有**数据支撑** 不能**凭感觉推测**。另外请**注意**输出**格式**要求。 → AI不知道哪句是重中之重5.2 引用块的妙用 引用块在提示词中有独特的信号含义“这是引用的外部内容/示例/背景材料不是给你的指令”。你的任务是分析以下用户反馈 这个App太卡了点一个按钮要等3秒钟我用了两天就卸载了。 请基于以上用户反馈分析可能的原因和优化建议。引用块让AI清楚地区分要分析的内容和给你的指令——这对于包含大量外部文本的提示词尤其重要。六、Markdown在提示词中的综合应用6.1 提示词整体结构设计 一个结构良好的Markdown提示词应该有清晰的视觉层次——读者包括AI和人类扫一眼就能理解信息的组织方式。推荐的整体结构# 主板块A一级标题 ## 子板块A1二级标题 - 内容项列表 - 内容项 ## 子板块A2二级标题 1. 有序步骤 2. 有序步骤 # 主板块B一级标题 引用或备注引用块 内容正文正文段落 # 主板块C一级标题 json { 示例数据: value }实际提示角色设定你是一位经验丰富的数据分析师。任务描述分析以下用户反馈数据找出核心问题并给出建议。分析要求必须涵盖问题识别用户的核心痛点是什么需引用具体反馈作为证据影响评估这个问题影响面多大严重程度如何建议方案给出2-3个具体的改进建议格式要求报告按以下结构组织摘要100字以内问题分析改进建议优先级建议约束条件字数总计不超过800字风格客观、具体、可操作引用每个结论必须引用至少一条用户反馈作为支撑数据输入用户反馈汇总“页面加载太慢了我试了3次都在转圈。”“功能很全但操作太复杂需要点很多次。”“客服响应很快好评。”“数据导出的格式有问题Excel打开乱码。”输出格式参考## 摘要 [简明扼要的概述] ## 问题分析 ### 问题1[问题名称] - 严重程度高/中/低 - 影响用户数X人 - 用户原声 [引用] - 根因分析[分析] ## 改进建议 1. [建议1] 2. [建议2]开始分析### 6.2 Markdown与分隔符的混用 Markdown和上一篇文章讲的分隔符可以互补使用用 隔离最大的域如示例域 vs 任务域用 # 组织域内的板块用 ## 组织板块内的子板块用列表组织条目 示例域 示例1输入…输出…示例2输入…输出… 任务域 任务描述…实际输入…这种混用策略利用了分隔符的强硬隔离能力和Markdown的层级组织能力。 --- ## 七、Markdown提示词的常见陷阱 ### 7.1 陷阱一代码块中的指令被忽略 ⚠️ 代码块中的内容可能被AI理解为要处理的文本/数据而非指令。❌ 错误把重要指令放在代码块中请务必以JSON格式输出且所有字段不能为空。→ AI可能认为这只是展示的格式示例而非必须遵守的指令✅ 正确指令放在代码块外的正文中请务必以JSON格式输出且所有字段不能为空。以下是JSON格式示例{field:value}### 7.2 陷阱二标题被误解为任务的主题⚠️ 如果提示词中说# 请帮我分析数据AI可能将请帮我分析数据理解为这是标题文本而非这是对我的指令。✅ 标题应该是板块名称指令放在正文中任务描述请帮我分析以下数据。### 7.3 陷阱三水平线在某些平台被截断 ⚠️ ---三个减号在Markdown中是水平线但在某些AI平台中可能被当作对话分隔符或提示词结束标记。✅ 用 代替 — 作为板块分隔不建议在提示词中使用 — 作为分隔符--- ## 八、完整实战案例 ### 8.1 案例构建一个技术方案评审的Markdown提示词 **场景**需要一个标准化的提示词模板用于评审技术方案文档。角色设定你是一位资深技术架构师拥有12年的系统设计经验。你的评审风格犀利但建设性——批评要到位但必须给出更好的方案。任务描述评审以下技术方案文档从以下维度进行评估并生成评审报告。评审维度架构设计系统架构的合理性和扩展性组件之间的耦合度和内聚性技术选型与场景的匹配度数据设计数据模型是否合理查询性能是否满足预期数据一致性保证机制可靠性故障处理机制是否完善是否有单点故障数据备份和恢复方案安全性认证和授权机制数据传输和存储的加密常见攻击向量的防护可维护性代码组织和模块划分日志和监控的设计部署和运维的复杂度评分标准每个维度按照以下标准评分分数含义5优秀无明显问题4良好有轻微可优化点3及格存在需要关注的问题2不足有明显缺陷1严重问题必须重新设计输出格式请严格按照以下格式输出评审报告# 技术方案评审报告 ## 总体评分 | 维度 | 评分 | 说明 | |------|------|------| | 架构设计 | X/5 | 一句话说明 | | 数据设计 | X/5 | 一句话说明 | | 可靠性 | X/5 | 一句话说明 | | 安全性 | X/5 | 一句话说明 | | 可维护性 | X/5 | 一句话说明 | **综合评分**X/25 ## 主要问题 ### 严重问题 [每个问题单独列出包含问题描述、影响分析、修复建议] ### 需关注的问题 [同上格式] ### 优化建议 [同上格式] ## 亮点 [方案中做得好的地方至少2点] ## 总结 [2-3句话的总结包含评审结论和改进方向]待评审方案[在此处粘贴技术方案文档]开始评审请基于以上所有要求对技术方案进行评审。### 8.2 案例要点解析 这个Markdown提示词的设计有几个值得注意的细节 1. **用# 标题组织顶层结构**角色、任务、评审维度、评分标准、输出格式——每个都是独立的顶层板块。 2. **用## 标题细分维度**架构设计、数据设计等是评审维度下的子维度。 3. **用表格展示评分标准**表格让分数和含义的对应关系一目了然。 4. **用代码块包裹输出格式**告诉AI这个格式模板不要当作自然语言来理解而是当作输出格式的参考。 5. **关键要求用粗体突出**犀利但建设性被粗体标记这是整个角色的核心特征。 6. **有序编号留给步骤列表**评审报告结构用数字编号暗示了输出时按这个顺序组织。 --- ## 核心要点总结 ✅ **Markdown在提示词中的核心价值**不是让提示词更好看而是利用AI训练数据中建立起来的Markdown格式-语义映射关系精确传递信息的层级、类型和重要性。每个Markdown元素都是一个语义信号。 ✅ **标题层级三原则**①不超过3级#/##/###②标题用描述性名称角色设定而非第一部分③层级关系反映信息的逻辑关系一级是板块二级是子板块三级是细项。 **列表使用的关键区分**有序列表用于步骤和优先级排序暗示先后顺序无序列表用于并列条目暗示无先后之分。嵌套不超过3层同层列表项必须是同类内容。 **代码块的三大用途**①包裹示例输出格式防止AI将其当作指令②包裹结构化数据JSON/XML/YAML③标注语言类型提供额外语义信号\\\json让AI知道这是JSON数据。行内代码用来标记技术术语和命令。 ⚠️ **粗体使用原则**整篇提示词中粗体控制在5处以内。粗体是高优先级信号用多了等于没有重点。关键约束用粗体一般内容不用。 **最佳组合策略**Markdown组织层级和语义 分隔符隔离大的域 引用块区分要处理的内容和给你的指令三者混用可以构建信息传递效率最高的提示词。 ⚠️ **三大陷阱**①代码块中的文本可能被AI当作展示内容而非指令②标题不应该包含指令性内容# 请帮我分析不如# 任务描述加正文请帮我分析③---在某些平台可能被当作对话截断符号推荐用替代。
Markdown格式在提示词中的应用技巧
Markdown格式在提示词中的应用技巧上一篇文章我们讲了用分隔符组织提示词。今天我们来深入一个更具体的话题——如何用Markdown格式来写提示词。Markdown不仅是一种排版语法在提示词工程中它是一套信息层级编码系统——通过标题、列表、代码块、粗体等元素你可以精确地告诉AI这段内容是什么级别、“那段内容是代码还是文本”、“这个信息比那个信息更重要”。掌握Markdown在提示词中的应用你的提示词信息传递效率能提升一个台阶。一、Markdown在提示词中的特殊价值1.1 不只是排版好看很多人以为在提示词中使用Markdown只是为了让提示词看起来更整洁。这个理解太表面了。Markdown在提示词中的核心价值不是美观而是语义信号。AI的训练数据中包含海量的Markdown格式文档GitHub上的README、技术博客、文档网站等。这意味着AI对Markdown的语义有深刻的理解——它知道# 标题是一级主题知道**粗体**是强调内容知道代码块中的内容应该被当作代码而非自然语言处理。当你使用Markdown格式时你利用的是AI在训练中建立起来的格式-语义映射关系。这比用普通文本分隔符传达信息要高效得多。1.2 Markdown的语义信号系统Markdown的每个语法元素都向AI发送一个特定的语义信号Markdown元素向AI传达的语义信号# 标题“这是最高层级的主要话题”## 二级标题“这是主话题下的一个子话题”**粗体**“这是需要特别注意的重要内容”*斜体*“这是术语或需要区分的特殊词汇”- 列表项“这是并列的独立条目”1. 有序列表“这些条目有先后顺序” 代码块 “这是代码/数据不要当作自然语言处理” 行内代码 “这是技术术语、变量名或命令” 引用“这是引用的内容或示例”--- 水平线“这是一个话题分隔前后是不同的内容板块” 理解了这个语义信号系统你就能更精确地使用Markdown来编写AI对你提示词的理解方式。二、标题层级的使用策略2.1 用标题构建信息层级 标题是Markdown中最强的语义信号。一个#和##的差别在AI的理解中是主题和子主题的差别。标题层级的最佳实践# 一级标题 → 用于提示词的最顶层板块如角色设定、任务要求 ## 二级标题 → 用于板块内的主要分类如内容要求、格式要求 ### 三级标题 → 用于分类内的细分项如字数要求、风格要求 #### 四级标题 → 尽量少用层级太深反而让结构复杂完整示例# 任务描述 分析Q2用户增长数据并生成报告。 # 角色设定 你是一位数据分析师擅长从数据中提取商业洞察。 # 分析要求 ## 内容维度 ### 用户增长 - 新增用户趋势分析 - 渠道来源分析 ### 用户留存 - 次日/7日/30日留存率 - 留存率变化的原因分析 ### 收入分析 - ARPU/ARPPU变化趋势 - 付费转化率分析 ## 格式要求 ### 报告结构 1. 摘要 2. 核心指标概览 3. 详细分析 4. 建议 ### 字数限制 - 总报告1500字以内 - 摘要200字以内 # 参考示例 [示例内容] # 数据输入 [数据]2.2 标题层级的数量控制⚠️一个提示词中的标题层级不要超过3级。超过3级后结构变得复杂AI反而可能迷失在层级中。✅ 最多3级标题 # 大板块 ## 子板块 ### 细项 到此为止 ❌ 过度嵌套 # 大板块 ## 子板块 ### 细项 #### 更细的项 ##### 太细了 ###### 失去意义了 如果发现需要4级以上的标题说明你的信息组织结构有问题——应该考虑展平层级或者将一些内容移到列表或段落中。2.3 标题的命名原则标题内容应该是描述性的而非结构性的。✅ 描述性标题AI能理解板块的内容性质 # 角色设定 # 数据分析要求 # 输出格式规范 # 参考示例 ❌ 结构性标题AI不知道每个板块是干什么的 # 第一部分 # 第二部分 # 第三部分三、列表的使用技巧3.1 有序列表 vs 无序列表 这个选择直接影响AI对这些条目之间的关系的理解。使用有序列表1. 2. 3.的场景步骤、流程、先后顺序明确的条目优先级排序从高到低时间顺序从前到后分析步骤 1. 先查看数据整体趋势 2. 再定位异常时间点 3. 然后分析异常维度的交叉影响 4. 最后形成结论和建议使用无序列表- * 的场景并列的要求、规则、特征无先后顺序的选项或要素清单式的检查要点分析中需关注的因素 - 季节性波动 - 竞品动态影响 - 产品功能变更 - 市场环境变化3.2 嵌套列表的深度控制⚠️嵌套列表不要超过3层。超过3层的嵌套在AI的理解中可能产生混淆。✅ 最多3层嵌套 - 数据分析 - 用户维度 1. 新增用户 2. 活跃用户 3. 流失用户 - 收入维度 1. 总收入 2. 人均收入 ❌ 过度嵌套 - 第一层 - 第二层 - 第三层 - 第四层开始失去结构意义 - 第五层AI可能无法准确理解层级关系3.3 列表项的一致性 同一层级的列表项应该是同类内容。不要在同一个列表中混合不同类型的条目。❌ 混合类型 分析要求 - 查看用户增长趋势行为 - 收入变化数据项 - 建议优化产品功能结论/建议 ✅ 同类一致 分析内容 - 用户增长趋势 - 收入变化分析 - 留存率变化分析 - 渠道效果对比 分析步骤 - 第一步数据概览 - 第二步异常定位 - 第三步原因分析 - 第四步形成建议四、代码块的正确使用4.1 什么时候用代码块 代码块告诉AI“这部分内容请按照代码/数据/结构化文本的方式理解不要当作自然语言指令。”应该放在代码块中的内容实际的代码片段JSON/XML/YAML等结构化数据示例输出格式提示词中的示例部分特别是格式示范不应该被AI当作指令解读的纯展示性内容✅ 用代码块包裹示例输出格式 请按照以下格式输出 json { analysis: 分析内容, score: 85, recommendations: [建议1, 建议2] }❌ 不用代码块AI可能混淆请按照以下格式输出{“analysis”: “分析内容”,“score”: 85,“recommendations”: [“建议1”, “建议2”]}### 4.2 代码块的语言标注 在代码块的开头标注语言类型能进一步帮助AI理解内容的性质。json → AI知道这是JSON数据会以数据格式理解 sql → AI知道这是SQL查询会以数据库查询语义理解 → 不加标注AI需要自行判断标注语言类型是一个零成本但有效的习惯建议养成。4.3 行内代码的妙用 行内代码用反引号包裹用于标记这不是普通文字而是技术术语、变量名、命令或特定值。✅ 使用行内代码的场景 请用 pandas.DataFrame.groupby() 进行分组聚合。 将 status 字段的值设置为 active 或 inactive。 运行 npm install 安装依赖。 不需要用行内代码的场景 今天天气很好适合出去散步。 请仔细分析用户反馈中的情感倾向。五、强调与引用5.1 粗体和斜体的信号强度 在提示词中粗体和斜体不仅是排版更是重要性信号。**粗体** 高优先级信号“这个信息特别重要请特别注意”*斜体* 低优先级信号“这是一个术语或特殊表达请注意区分”***粗斜体*** 最高优先级信号慎用用多了就没效果了⚠️使用原则一篇提示词中粗体的使用应该控制在5处以内。如果到处都是粗体那就没有重点了——AI会对所有粗体内容一视同仁地重视等于没有突出任何东西。✅ 适度使用粗体突出最关键的要求 请分析以下数据。**最重要的要求所有结论必须有数据支撑不能凭感觉推测。** 另外请注意输出格式要求。 ❌ 过度使用粗体失去了突出重点的作用 请**分析**以下**数据**。**最重要**的要求**所有结论**必须有**数据支撑** 不能**凭感觉推测**。另外请**注意**输出**格式**要求。 → AI不知道哪句是重中之重5.2 引用块的妙用 引用块在提示词中有独特的信号含义“这是引用的外部内容/示例/背景材料不是给你的指令”。你的任务是分析以下用户反馈 这个App太卡了点一个按钮要等3秒钟我用了两天就卸载了。 请基于以上用户反馈分析可能的原因和优化建议。引用块让AI清楚地区分要分析的内容和给你的指令——这对于包含大量外部文本的提示词尤其重要。六、Markdown在提示词中的综合应用6.1 提示词整体结构设计 一个结构良好的Markdown提示词应该有清晰的视觉层次——读者包括AI和人类扫一眼就能理解信息的组织方式。推荐的整体结构# 主板块A一级标题 ## 子板块A1二级标题 - 内容项列表 - 内容项 ## 子板块A2二级标题 1. 有序步骤 2. 有序步骤 # 主板块B一级标题 引用或备注引用块 内容正文正文段落 # 主板块C一级标题 json { 示例数据: value }实际提示角色设定你是一位经验丰富的数据分析师。任务描述分析以下用户反馈数据找出核心问题并给出建议。分析要求必须涵盖问题识别用户的核心痛点是什么需引用具体反馈作为证据影响评估这个问题影响面多大严重程度如何建议方案给出2-3个具体的改进建议格式要求报告按以下结构组织摘要100字以内问题分析改进建议优先级建议约束条件字数总计不超过800字风格客观、具体、可操作引用每个结论必须引用至少一条用户反馈作为支撑数据输入用户反馈汇总“页面加载太慢了我试了3次都在转圈。”“功能很全但操作太复杂需要点很多次。”“客服响应很快好评。”“数据导出的格式有问题Excel打开乱码。”输出格式参考## 摘要 [简明扼要的概述] ## 问题分析 ### 问题1[问题名称] - 严重程度高/中/低 - 影响用户数X人 - 用户原声 [引用] - 根因分析[分析] ## 改进建议 1. [建议1] 2. [建议2]开始分析### 6.2 Markdown与分隔符的混用 Markdown和上一篇文章讲的分隔符可以互补使用用 隔离最大的域如示例域 vs 任务域用 # 组织域内的板块用 ## 组织板块内的子板块用列表组织条目 示例域 示例1输入…输出…示例2输入…输出… 任务域 任务描述…实际输入…这种混用策略利用了分隔符的强硬隔离能力和Markdown的层级组织能力。 --- ## 七、Markdown提示词的常见陷阱 ### 7.1 陷阱一代码块中的指令被忽略 ⚠️ 代码块中的内容可能被AI理解为要处理的文本/数据而非指令。❌ 错误把重要指令放在代码块中请务必以JSON格式输出且所有字段不能为空。→ AI可能认为这只是展示的格式示例而非必须遵守的指令✅ 正确指令放在代码块外的正文中请务必以JSON格式输出且所有字段不能为空。以下是JSON格式示例{field:value}### 7.2 陷阱二标题被误解为任务的主题⚠️ 如果提示词中说# 请帮我分析数据AI可能将请帮我分析数据理解为这是标题文本而非这是对我的指令。✅ 标题应该是板块名称指令放在正文中任务描述请帮我分析以下数据。### 7.3 陷阱三水平线在某些平台被截断 ⚠️ ---三个减号在Markdown中是水平线但在某些AI平台中可能被当作对话分隔符或提示词结束标记。✅ 用 代替 — 作为板块分隔不建议在提示词中使用 — 作为分隔符--- ## 八、完整实战案例 ### 8.1 案例构建一个技术方案评审的Markdown提示词 **场景**需要一个标准化的提示词模板用于评审技术方案文档。角色设定你是一位资深技术架构师拥有12年的系统设计经验。你的评审风格犀利但建设性——批评要到位但必须给出更好的方案。任务描述评审以下技术方案文档从以下维度进行评估并生成评审报告。评审维度架构设计系统架构的合理性和扩展性组件之间的耦合度和内聚性技术选型与场景的匹配度数据设计数据模型是否合理查询性能是否满足预期数据一致性保证机制可靠性故障处理机制是否完善是否有单点故障数据备份和恢复方案安全性认证和授权机制数据传输和存储的加密常见攻击向量的防护可维护性代码组织和模块划分日志和监控的设计部署和运维的复杂度评分标准每个维度按照以下标准评分分数含义5优秀无明显问题4良好有轻微可优化点3及格存在需要关注的问题2不足有明显缺陷1严重问题必须重新设计输出格式请严格按照以下格式输出评审报告# 技术方案评审报告 ## 总体评分 | 维度 | 评分 | 说明 | |------|------|------| | 架构设计 | X/5 | 一句话说明 | | 数据设计 | X/5 | 一句话说明 | | 可靠性 | X/5 | 一句话说明 | | 安全性 | X/5 | 一句话说明 | | 可维护性 | X/5 | 一句话说明 | **综合评分**X/25 ## 主要问题 ### 严重问题 [每个问题单独列出包含问题描述、影响分析、修复建议] ### 需关注的问题 [同上格式] ### 优化建议 [同上格式] ## 亮点 [方案中做得好的地方至少2点] ## 总结 [2-3句话的总结包含评审结论和改进方向]待评审方案[在此处粘贴技术方案文档]开始评审请基于以上所有要求对技术方案进行评审。### 8.2 案例要点解析 这个Markdown提示词的设计有几个值得注意的细节 1. **用# 标题组织顶层结构**角色、任务、评审维度、评分标准、输出格式——每个都是独立的顶层板块。 2. **用## 标题细分维度**架构设计、数据设计等是评审维度下的子维度。 3. **用表格展示评分标准**表格让分数和含义的对应关系一目了然。 4. **用代码块包裹输出格式**告诉AI这个格式模板不要当作自然语言来理解而是当作输出格式的参考。 5. **关键要求用粗体突出**犀利但建设性被粗体标记这是整个角色的核心特征。 6. **有序编号留给步骤列表**评审报告结构用数字编号暗示了输出时按这个顺序组织。 --- ## 核心要点总结 ✅ **Markdown在提示词中的核心价值**不是让提示词更好看而是利用AI训练数据中建立起来的Markdown格式-语义映射关系精确传递信息的层级、类型和重要性。每个Markdown元素都是一个语义信号。 ✅ **标题层级三原则**①不超过3级#/##/###②标题用描述性名称角色设定而非第一部分③层级关系反映信息的逻辑关系一级是板块二级是子板块三级是细项。 **列表使用的关键区分**有序列表用于步骤和优先级排序暗示先后顺序无序列表用于并列条目暗示无先后之分。嵌套不超过3层同层列表项必须是同类内容。 **代码块的三大用途**①包裹示例输出格式防止AI将其当作指令②包裹结构化数据JSON/XML/YAML③标注语言类型提供额外语义信号\\\json让AI知道这是JSON数据。行内代码用来标记技术术语和命令。 ⚠️ **粗体使用原则**整篇提示词中粗体控制在5处以内。粗体是高优先级信号用多了等于没有重点。关键约束用粗体一般内容不用。 **最佳组合策略**Markdown组织层级和语义 分隔符隔离大的域 引用块区分要处理的内容和给你的指令三者混用可以构建信息传递效率最高的提示词。 ⚠️ **三大陷阱**①代码块中的文本可能被AI当作展示内容而非指令②标题不应该包含指令性内容# 请帮我分析不如# 任务描述加正文请帮我分析③---在某些平台可能被当作对话截断符号推荐用替代。
