GitLab编辑器中Markdown列表嵌入多行代码的格式问题

解决GitLab Wiki列表中代码块对齐的问题 #

我太懂你在GitLab Wiki里碰的这个排版坑了——列表里的多行代码要么显示得乱七八糟，要么没法跟项目符号对齐，对吧？其实GitLab的Markdown解析器（基于CommonMark规范）对列表嵌套代码块有明确的格式要求，试试下面这个写法就能解决：

• Test

  var somecode = 5;
  somecode++;
  

• Another line

为什么这个写法能生效？

当你在列表项里嵌套代码块时，需要给代码块添加与列表层级匹配的缩进（这里用2个空格就足够）。这样解析器就能明确识别出这段代码属于当前的列表项，自然就会和前面的项目符号对齐了。

再说说你之前两种写法的问题：

1. 第一种（无空行）：

   - Test
   ```javascript
   var somecode = 5;
   somecode++;
   

   • Another line

   这种写法里，解析器会把代码块当成列表之外的独立内容，完全没法关联到前面的列表项，所以显示肯定会异常。
   
   

2. 第二种（有空行但无缩进）：

   - Test
   
   ```javascript
   var somecode = 5;
   somecode++;
   

   • Another line

   空行确实能让代码块正常显示，但因为没加缩进，解析器还是把它当成脱离列表的单独元素，所以没法和项目符号对齐。
   
   

只要给代码块补上对应层级的缩进，就能完美实现你想要的对齐效果啦！

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