Markdown里的foo_bar_baz为什么没有斜体?下划线与星号有何不同?
技术文档里常见带下划线的字段名。把foo_bar_baz贴进Markdown,文字保持原样;换成词中一对星号,却可能让中间的bar变成斜体。两种符号都能表示强调,但它们在词内部的定界条件有区别。
2026年11月20日,在Markdown转HTML工具分别输入foo_bar_baz、foo*bar*baz与foo _bar_ baz。当前输出中,第一项仍是普通文字,后两项都为bar生成em标签。

观察符号两侧的字符
CommonMark对词内下划线强调施加限制,便于保留这类名称;星号允许的词内强调范围不同。这里关注的是具体位置,不能只记成“下划线永远不支持斜体”。第三项在bar两侧留下合适边界后,已经显示它可以用于强调。
本机读取三段生成HTML,共找到两个em节点。另一个字段名示例放进行内代码后,输出为code节点,字段名的下划线完整保留;旁边单独强调的bar仍为em。这样可以在一段说明里同时表达字段名和强调内容。

字段名优先使用代码语义
写配置键、文件名或短命令时,用行内代码包住名称,更容易把它与强调样式分开。若确实要强调某段自然语言文字,按预期范围放置定界符,再看生成的标签是否只包住那一段。
不要为追求相同视觉,把字段名中的下划线改成星号;名称本身也会随之改变。需要在行内代码里展示反引号时,可以参考行内代码定界符的用法。最终发布编辑器可能采用扩展规则,检查源码与目标预览能及时发现差异。