Cucumber/Gherkin特性描述中Markdown不生效问题咨询

你遇到的这个情况大概率不是Bug，而是需要核对几个配置或使用细节，以下是具体排查方向：

1. 确认Cucumber版本 #

旧版本的HTML formatter对Markdown的支持存在局限，比如部分早期的Java/.NET/Cucumber-JS版本，建议升级到最新稳定版（如Cucumber-JVM 7.x+、Cucumber-JS 8.x+），新版本对Markdown行内格式的解析支持更完善。

2. 检查HTML formatter的配置 #

不同语言的Cucumber实现，启用官方HTML formatter的方式不同，需确保你用的是官方原生的HTML formatter：

• Java：通过注解或命令行指定正确的formatter：

  @CucumberOptions(plugin = {"html:target/cucumber-report.html"})
  

  或命令行参数：

  mvn test -Dcucumber.plugin="html:target/report.html"
  

• JavaScript：通过命令行指定官方HTML formatter：

  cucumber-js --format html:report.html
  

  注意不要使用第三方的旧版formatter，这类工具可能不支持Markdown解析。

3. 验证Markdown语法的支持范围 #

Cucumber仅对Feature描述中的基础行内Markdown格式提供支持，包括：

• **粗体文本**
• _斜体文本_
• `代码片段`
  像多级标题、列表、图片这类复杂Markdown语法，官方HTML formatter并不支持，你的示例中用的_和**属于支持范围，所以重点还是看版本和配置。

4. 确认Feature描述的缩进规范 #

Gherkin对缩进要求严格，Feature描述的每一行必须和Feature标题保持一致的缩进（通常为4个空格），如果缩进错误，formatter会将其识别为普通文本，不会解析Markdown。你提供的示例缩进是正确的，但可以再核对实际文件中的缩进是否统一。

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