3.3 技能开发基础:Markdown语法

📅 2026/7/27 22:28:22
3.3 技能开发基础:Markdown语法
《扣子编程从一句话到产品上线零门槛AI心流开发》全书案例分享~持续更新-CSDN博客技能本质是文档化的业务规则因此必须依托一套统一、标准、AI高适配的排版语法即 Markdown 语法。Markdown 是整个零代码智能体开发的底层基石是AI可精准解析、可强制约束、可标准化渲染的专用文稿语言。不同于自由文本Markdown 可以通过固定标记让大模型区分“规则层级、强制要求、结构框架、输出模板”从根源上避免AI自由发挥、输出混乱、结构错乱。Markdown 是一种轻量化标记式排版语言用少量简易符号实现文档分级、加粗、列表、分段无需复杂排版代码编写的文档人类可读、大模型可精准解析是扣子平台技能说明书SKILL.md的专用编写格式。Markdown 是一种轻量级、结构化、易读写的标记语言是扣子智能体技能开发的专属标准书写规范。它无需复杂编程代码仅通过简易固定符号就能实现文档结构化排版既方便开发者编写技能说明书也能被大模型精准识别、严格执行格式规则。在智能体开发中技能本质是标准化任务说明书而 Markdown 是这份说明书的核心载体核心作用并非页面美化而是规则约束。若使用纯文字编写技能规则大模型会自由发挥导致每次生成的股票分析报告结构混乱、排版不一、内容零散无法实现标准化输出。而 Markdown 可以固定任务层级、执行步骤和输出格式强制大模型统一执行逻辑让智能体每次运行效果一致真正实现零代码智能体的标准化开发。针对零基础学习者本节聚焦智能体开发最核心、必用的三类语法标题语法、段落语法、列表语法结合股票分析智能体实操场景搭配通俗案例可直接上手复用。1.标题语法构建报告整体框架标题语法是 Markdown 最核心的基础语法主要用于划分文档层级、搭建技能任务和分析报告的整体框架强制大模型按固定模块分区输出内容杜绝内容杂乱、章节混淆。语法规则简单固定通过“#”符号区分层级符号数量越少标题层级越高所有#符号后必须加英文空格语法方可生效。该语法完美适配股票分析报告的多维度分级结构。实操语法与效果示例如下原始代码# A股个股智能分析报告一级标题全文总标题## 1.技术面分析二级标题核心分析模块### 1.1 K线与均线指标研判三级标题细分分析维度实际作用自动生成层级清晰的结构化框架约束AI严格按照“总报告—核心模块—细分维度”的逻辑输出内容是标准化报告的基础框架。2.段落语法规整正文与版式规范段落语法是保障技能说明书、最终分析报告版式整洁、可读性强的基础语法主要用于正文内容排版、内容分区、规则备注解决纯文字堆砌、排版混乱、段落无区分的问题适配小白零基础排版。核心包含分段、换行、重点强调、备注引用四类常用规则适配所有智能体文案输出场景。实操语法与效果示例1分段规则段落与段落之间空一行自动区分独立内容板块。示例写完技术面分析正文后空一行再编写资金面分析正文两大模块自动分区版式整洁。2重点强调规则使用两对星号**文字**包裹文字标注强制约束规则。示例**风险提示本报告仅基于公开历史数据做客观统计分析不构成任何投资建议**。3备注引用规则使用“ 英文空格”编写引用内容单独放置免责声明、补充备注。示例 股市有风险投资需谨慎所有分析结果仅供学习参考。4行内参数标注使用单个反引号 内容 标注专业参数、接口字段。示例本智能体核心入参为stock_code仅支持6位A股数字代码。3.列表语法拆解流程与罗列指标列表语法用于拆解复杂业务逻辑、罗列数据指标、规范执行步骤让零散的内容条理化、有序化既方便小白梳理开发流程也能降低大模型的理解偏差让工具调用、数据分析、报告生成的流程更标准。分为无序列表和有序列表两种均需在符号后添加英文空格。1无序列表适用于罗列指标、要素、条件语法以“-英文空格”开头逐条罗列平行内容。实操示例-核心技术指标MA5、MA10、MA20均线-辅助分析指标MACD、KDJ、成交量-核心数据来源东方财富、新浪财经公开接口2有序列表适用于规范步骤、流程操作语法以“数字.英文空格”开头按顺序罗列操作步骤。实操示例1.接收用户输入的6位A股股票代码2.调用公开接口采集股价、K线、财报、新闻数据3.多维度解析数据生成标准化分析报告4.自动导出PDF格式报告文件4表格语法标准 Markdown 表格由表头分隔行| --- | --- | --- |实现列对齐竖线|划分单元格结构分为表头行、分隔行、内容行三部分分隔行短横线搭配冒号可控制对齐:居左、---: 居右、---: :居中在 Coze 技能文档中一般统一使用简易居中格式。| Syntax | Description | Test Text || :--- | :----: | ---: || Header | Title | Heres this || Paragraph | Text | And more |呈现出来的输出格式如图3-1所示表格输出控制对齐。图3-1 表格语法输出结果对于零基础开发者需牢记核心规范所有 Markdown 标记符号后必须添加英文空格否则语法失效会导致AI解析错乱、报告排版崩盘。同时扣子编程的技能开发无需掌握图片、超链接、复杂表格等冗余语法熟练掌握上述标题、段落、列表、表格四大核心语法即可完成所有技能的规范化编写与标准化报告输出。Markdown 凭借极简标记符号实现文档结构化编写是技能说明书标准化落地的底层基础开发者通过标题、加粗、列表等语法把业务 SOP 固化成机器可读文档最终实现 AI 报告格式统一、输出可控。