行内代码语法用单个反引号包裹内容 →代码片段核心规则反引号后必须紧跟内容无空格内容结束立即闭合反引号用于短代码片段变量名userId、命令npm install、文件名README.md、关键词等特殊字符处理显示单个反引号用双反引号包裹 → 源码 → 渲染显示双反引号用三反引号包裹 →源码→ 渲染示例修改配置文件 config.yaml 中的 timeout 参数。 转义技巧用 表示反引号字符。渲染效果修改配置文件config.yaml中的timeout参数。转义技巧用表示反引号字符。 代码区块多行代码 缩进式代码块传统方式兼容旧系统语法每行开头添加4 个空格或1 个 Tab特点⚠️ 无语法高亮⚠️ 易与普通段落混淆⚠️ 维护成本高需逐行缩进✅ 适用于极简环境或老旧解析器示例每行前含4空格// 传统缩进式 function legacy() { return avoid if possible; } 围栏式代码块现代标准强烈推荐 ✨语法[语言标识] 代码内容 核心优势✅ 自动语法高亮指定语言后✅ 无需逐行缩进结构清晰✅ 支持标题、行号等扩展功能依平台而定语言标识示例pythonjavascriptbashjsonhtmlcsssqlyamldockerfile完整语言列表参考实战示例python titlegreet.py def greet(name: str) - str: 返回问候语 return f✨ Hello, {name}! 欢迎学习 Markdown print(greet(开发者)) 渲染效果带高亮defgreet(name:str)-str:返回问候语returnf✨ Hello,{name}! 欢迎学习 Markdownprint(greet(开发者))无语言标识纯文本 保留原始格式 无语法高亮 适合日志/纯文本片段 专业建议与避坑指南场景推荐方案原因说明单词/短语级代码行内代码轻量、语义清晰多行代码/脚本围栏式 高亮、易维护、现代标准兼容老旧邮件系统缩进式4空格极端兼容需求代码中含反引号增加界定符数量→ ⚠️ 常见陷阱行内代码空格陷阱error错误反引号与内容间有空格→error正确围栏闭合遗漏三反引号必须成对出现且单独成行语言标识大小写多数解析器不区分大小写JS≈javascript但建议使用小写保持规范嵌套代码块展示 Markdown 源码时外层用四反引号包裹内容 平台兼容性完美支持围栏式GitHub、GitLab、Obsidian、Typora、Notion、VS Code仅支持缩进式部分邮件客户端、老旧 Wiki 系统建议提前测试学习提示在笔记中描述代码时善用“行内代码围栏代码块”组合“调用init()函数参考完整实现functioninit(){console.log(初始化完成);} 让文档兼具可读性与专业性