如何在Compodoc的Markdown语法高亮及SCSS代码块中显示&符号

我之前在Compodoc里编写SCSS代码块时，也碰到过一模一样的&符号显示异常问题，折腾了好一会儿才找到靠谱的解决方式，分享给你：

正确写法：直接在代码块中使用原始&符号 #

不需要做任何HTML转义操作，用三个反引号包裹SCSS代码块，直接写&就能正常显示：

.my-class { 
  &:before{ 
    margin-right: 5px; 
  } 
}

为什么你之前的尝试没效果？ #

• 用&：这是Markdown普通文本中显示&的转义方式，但代码块会把它当作普通文本解析，最终被Compodoc处理成了空格；
• 用&：这会被解析成&这个文本本身，而非你需要的&符号；
• 用&：代码块会直接显示这个HTML实体的字面内容，不会自动转换成&。

核心原因就是Markdown代码块内的内容处于原始文本模式，不需要用HTML实体转义特殊字符，直接写标准的SCSS语法即可。

内容的提问来源于stack exchange，提问作者Jason