markdown的语法按钮

语法按钮的本质，是把输入标记的动作封装成一次点击。判断要不要用某个按钮，标准只有两条：它是否减少重复输入；它是否降低语法错误。不符合这两条的按钮，完全可以不用。以下按常见按钮分组说明，给出适用场景、判断标准和注意事项。

1. 标题按钮：控制结构而不是放大字号

适用场景：文档分节、长文导航、自动生成目录。 判断标准：标题应当表达层级关系，不应为了视觉突出而跳级使用。通常一篇文档只保留一个一级标题，正文从二级开始。 操作：选中文本，点击 `H1` 至 `H6`，或直接输入 `#` 到 `######`。 注意事项：不要从 `H1` 跳到 `H3`；不要用加粗代替标题。渲染后标题会进入大纲，层级混乱会直接影响可读性。

2. 强调按钮：粗体、斜体与删除线

适用场景：加粗关键结论、标记术语、展示变更删除。 判断标准：一屏内粗体不宜超过两三处；斜体只用于书名、外来术语或轻微强调；删除线适合变更记录、待办完成前的划掉。 操作：选中文字点击 `B`、`I` 或删除线按钮，等价于 `文本`、`文本`、`~~文本~~`。 注意事项：不要整段加粗，否则失去重点；不要同时用粗体和斜体强调同一词，除非确实需要双重语义；删除线在 CommonMark 中不是标准语法，属于 GFM 扩展。

3. 列表与任务按钮：把并列和顺序写清楚

适用场景：操作步骤、待办清单、并列要点。 判断标准：有先后顺序用有序列表；没有顺序用无序列表；需要勾选用任务列表。 操作：点击无序列表、有序列表或任务列表按钮，随后输入条目，回车自动续接；缩进用 `Tab` 或空格上升一层。 注意事项：任务列表 `- [ ]` 依赖 GitHub Flavored Markdown，部分平台不支持；手动编号虽然多数渲染器能显示，但修改顺序时容易出错，建议交给有序列表按钮自动编号；同一列表内不要混用 `-`、`*`、`+`。

4. 引用与代码按钮：区分原文和可执行内容

适用场景：摘录外部资料、提示风险、命令、路径、配置片段。 判断标准：引用用于他人原文或提示块；行内代码用于命令、参数、文件名；多行代码用代码块。 操作：点击引用按钮输入 `>`；选中单词点击行内代码按钮生成反引号；代码块按钮插入三反引号并选择语言。 注意事项：引用块内可以嵌套列表和其他块，但不要只为了缩进使用引用；代码块务必标注语言，例如 ` ```bash `，否则无法高亮；行内代码不要滥用，整段命令应放代码块。

5. 链接与图片按钮：控制跳转和资源加载

适用场景：外部资料、内部锚点、截图、流程图。 判断标准：链接文字应说明目的，避免“点击这里”；图片必须有替代文字，说明图片内容而非“图片”。 操作：点击链接按钮填入 `[文字](URL "标题")`，标题可省略；图片按钮生成 ``。 注意事项：如果 URL 中含有空格，用 `%20` 或尖括号包裹；标题属性在部分平台不会显示，不应承载关键信息；图片要确认路径可访问，文档发布前检查是否加载。

6. 表格与分隔线按钮：结构化对比和节奏控制

适用场景：参数对比、字段说明、版本差异。 判断标准：需要多列对齐时用表格；分隔线只用于段落之间的大切换，不应频繁使用。 操作：表格按钮插入示例表格，至少包含表头、分隔行和一行数据，保持列数一致；对齐在分隔行用 `:---`、`:---:`、`---:` 控制。 注意事项：单元格内出现竖线要写 `\|`；分隔行不要写错列数，否则表格无法渲染；分隔线 `---` 需要与前一行空行配合，否则可能被解析为标题下划线。

小结

语法按钮的价值在于降低输入成本，但不应取代对 Markdown 结构的理解。建议把常用语法记到肌肉记忆，按钮只用于低频、长片段或容易出错的场景，比如表格、链接、图片。发布前检查三点：标题层级是否跳级、表格列数是否一致、图片和链接是否可访问。这样可以避免“按钮都会点，渲染出来却不对”的常见问题。