寻求Slate解析的Markdown表格行专属隐藏注释实现方案

我之前在维护Slate文档的时候正好遇到过一模一样的问题！试了好几种方法踩坑后，终于找到两个靠谱的解决方案，既能给表格每行加专属注释，又不会出现在生成的HTML里：

方案1：三横杠HTML注释 #

Slate使用的Redcarpet解析器对<!--- 注释内容 --->这种三横杠的HTML注释有特殊处理——它会直接忽略这些注释，不会把它们渲染到最终的HTML中。你可以把注释放在对应表格行的下方，和行一一对应：

| 产品名称 | 价格 |
|----------|------|
| 基础版 | 99元/月 |
<!--- 这一行是面向个人用户的入门套餐，包含核心功能 --->
| 专业版 | 199元/月 |
<!--- 企业用户首选，支持团队协作与API访问 --->

这种方法的好处是直观，注释和对应行紧挨着，阅读Markdown源码的时候一眼就能看明白关联关系。

方案2：未引用的链接引用定义 #

Markdown的链接引用定义如果没有被任何地方引用，是不会被渲染到HTML中的。你可以给每行定义一个唯一的引用标签，放在对应行的下方，用来做专属注释：

| 产品名称 | 价格 |
|----------|------|
| 基础版 | 99元/月 |
[row-basic]: # (面向个人用户的入门套餐，包含核心功能)
| 专业版 | 199元/月 |
[row-pro]: # (企业用户首选，支持团队协作与API访问)

这种方法的优势是注释格式符合Markdown规范，不会引入HTML语法，如果你团队偏好纯Markdown写法的话会很合适。

我当时用第一种方案解决了需求，亲测有效——生成的HTML里完全看不到这些注释，源码里的注释又能清晰对应到表格行。

内容的提问来源于stack exchange，提问作者V. Déhaye