JS文件与JS模块有哪些核心区别?
Markdown易混淆概念核心差异
以下是Markdown使用场景下最高频被混用的两组概念的核心差异,足够覆盖绝大多数混用场景:
1. 强调文本与行内代码
二者是新手最常误用的两种格式,核心差异为使用场景和语义完全不同:
- 强调文本(使用
*包裹内容):仅用于突出普通文本的重要性,不改变文本本身的语义,渲染后显示为斜体(单星号)或粗体(双星号)效果。示例写法:*注意:修改配置前请备份原有文件*,渲染效果为:注意:修改配置前请备份原有文件 - 行内代码(使用反引号
`包裹内容):用于标记代码片段、命令、变量名、标识符等技术类内容,自带“这是代码/技术专有名词”的语义,渲染后为等宽字体加浅背景效果。示例写法:执行cd /opt命令切换到应用目录,渲染效果为:执行cd /opt命令切换到应用目录
典型误用:将普通强调内容用反引号包裹,或是将代码片段用星号包裹,既不符合排版规范,也会导致内容语义混乱。
2. 块引用与代码块
二者都是多行内容格式,也经常被混用,核心差异同样是语义和场景区别:
- 块引用(使用
>开头):用于引用他人言论、官方文档原文、补充说明类内容,渲染后为左侧带竖线的缩进效果。示例:
本功能从2.3.0版本开始支持,低于该版本的环境需要先升级再使用。
- 代码块(使用三个反引号包裹内容):用于展示多行代码、命令输出、配置文件内容等,渲染后为独立的等宽字体块,部分渲染器支持对应编程语言的语法高亮。示例:
def add(a, b): return a + b
典型误用:将多行代码放入块引用,或是将大段引用文字放入代码块,会大幅降低内容可读性。
内容的提问来源于stack exchange,提问作者CqN
相关产品推荐
相关产品推荐

