{"action":"closed","issue":{"url":"https://api.github.com/repos/OpenMindClub/OMOOC.py/issues/10","labels_url":"https://api.github.com/repos/OpenMindClub/OMOOC.py/issues/10/labels{/name}","comments_url":"https://api.github.com/repos/OpenMindClub/OMOOC.py/issues/10/comments","events_url":"https://api.github.com/repos/OpenMindClub/OMOOC.py/issues/10/events","html_url":"https://github.com/OpenMindClub/OMOOC.py/issues/10","id":62139027,"number":10,"title":"Markdown 列表FAQ(FAQ about Markdown List)","user":{"login":"fengdasuk19","id":11484001,"avatar_url":"https://avatars.githubusercontent.com/u/11484001?v=3","gravatar_id":"","url":"https://api.github.com/users/fengdasuk19","html_url":"https://github.com/fengdasuk19","followers_url":"https://api.github.com/users/fengdasuk19/followers","following_url":"https://api.github.com/users/fengdasuk19/following{/other_user}","gists_url":"https://api.github.com/users/fengdasuk19/gists{/gist_id}","starred_url":"https://api.github.com/users/fengdasuk19/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/fengdasuk19/subscriptions","organizations_url":"https://api.github.com/users/fengdasuk19/orgs","repos_url":"https://api.github.com/users/fengdasuk19/repos","events_url":"https://api.github.com/users/fengdasuk19/events{/privacy}","received_events_url":"https://api.github.com/users/fengdasuk19/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/OpenMindClub/OMOOC.py/labels/help%20wanted","name":"help wanted","color":"159818"}],"state":"closed","locked":false,"assignee":null,"milestone":{"url":"https://api.github.com/repos/OpenMindClub/OMOOC.py/milestones/2","html_url":"https://github.com/OpenMindClub/OMOOC.py/milestones/101","labels_url":"https://api.github.com/repos/OpenMindClub/OMOOC.py/milestones/2/labels","id":1016344,"number":2,"title":"101","description":"在集体冲关前完成基础知识的夯实","creator":{"login":"ZoomQuiet","id":22494,"avatar_url":"https://avatars.githubusercontent.com/u/22494?v=3","gravatar_id":"","url":"https://api.github.com/users/ZoomQuiet","html_url":"https://github.com/ZoomQuiet","followers_url":"https://api.github.com/users/ZoomQuiet/followers","following_url":"https://api.github.com/users/ZoomQuiet/following{/other_user}","gists_url":"https://api.github.com/users/ZoomQuiet/gists{/gist_id}","starred_url":"https://api.github.com/users/ZoomQuiet/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ZoomQuiet/subscriptions","organizations_url":"https://api.github.com/users/ZoomQuiet/orgs","repos_url":"https://api.github.com/users/ZoomQuiet/repos","events_url":"https://api.github.com/users/ZoomQuiet/events{/privacy}","received_events_url":"https://api.github.com/users/ZoomQuiet/received_events","type":"User","site_admin":false},"open_issues":5,"closed_issues":2,"state":"open","created_at":"2015-03-11T12:53:01Z","updated_at":"2015-09-23T11:58:29Z","due_on":null,"closed_at":null},"comments":1,"created_at":"2015-03-16T16:43:03Z","updated_at":"2015-09-23T11:58:29Z","closed_at":"2015-09-23T11:58:29Z","body":"# Markdown 列表FAQ(FAQ about Markdown List) #\r\n\r\n## Q1 重新计数 与 缩进 ##\r\n\r\n### 表现 ###\r\n\r\n1. 水果\r\n\r\n苹果  \r\n李子\r\n\r\n2. 蔬菜\r\n\r\n生菜  \r\n西红柿\r\n\r\n3. 肉类\r\n\r\n鸡肉  \r\n鱼肉\r\n\r\n### 概述 ###\r\n\r\n这里的问题是：\r\n\r\n1. **每个列表都重新计数了（从 1 开始）**\r\n2. 每个列表下面的具体内容看起来并没有归该表头所有（没有缩进）\r\n\r\n\r\n### 分析 ###\r\n\r\n造成问题的原始代码如下：\r\n\r\n> `1. 水果`  \r\n> \r\n> `苹果`\r\n> `李子`\r\n> \r\n> `2. 蔬菜`  \r\n> \r\n> `生菜`\r\n> `西红柿`\r\n> \r\n> `3. 肉类`  \r\n> \r\n> `鸡肉`\r\n> `鱼肉`\r\n\r\n\r\n注意到：每个列表内容**前后均有一个空行**。  \r\n\r\n### 尝试1 ###\r\n\r\n让我们删去表头与其**下**内容之间的空行试试，即当代码是这样的时候：\r\n> `1. 水果` \r\n> `苹果`\r\n> `李子`\r\n> \r\n> `2. 蔬菜`\r\n> `生菜`\r\n> `西红柿`\r\n> \r\n> `3. 肉类`\r\n> `鸡肉`\r\n> `鱼肉`\r\n\r\n显示效果是： \r\n\r\n1. 水果  \r\n苹果\r\n李子\r\n\r\n2. 蔬菜  \r\n生菜\r\n西红柿\r\n\r\n3. 肉类  \r\n鸡肉\r\n鱼肉\r\n\r\n两个问题都得到了解决！  \r\n\r\n### 尝试2 ###\r\n\r\n要是删去表头与其**上**内容之间的空行，即当代码是这样的时候：\r\n> `1. 水果`\r\n> \r\n> `苹果`\r\n> `李子`\r\n> `2. 蔬菜`\r\n> \r\n> `生菜`\r\n> `西红柿`\r\n> `3. 肉类`\r\n> \r\n> `鸡肉`\r\n> `鱼肉`\r\n\r\n显示效果是：\r\n\r\n1. 水果\r\n\r\n苹果\r\n李子\r\n2. 蔬菜\r\n \r\n生菜\r\n西红柿\r\n3. 肉类\r\n \r\n鸡肉\r\n鱼肉\r\n\r\n看来这 2 个问题都没有得到解决（注意到 2 和 3 被 markdown 的实现当成了文本来处理）。\r\n\r\n### 尝试3 ###\r\n\r\n要是将这两个空行都删除，即当代码是这样的时候：\r\n> `1. 水果`\r\n> `苹果`\r\n> `李子`\r\n> `2. 蔬菜`\r\n> `生菜`\r\n> `西红柿`\r\n> `3. 肉类`\r\n> `鸡肉`\r\n> `鱼肉`\r\n\r\n显示效果是：  \r\n\r\n1. 水果  \r\n苹果  \r\n李子\r\n2. 蔬菜  \r\n生菜  \r\n西红柿\r\n3. 肉类  \r\n鸡肉  \r\n鱼肉\r\n\r\n在 GitHub 下的实现好像也可以？\r\n在 MarkdownPad 2 下的实现是和尝试2结果一致的，均被编辑器当成文本，而不会被当成列表。\r\n\r\n### A1 解决 ###\r\n\r\n综上所述：\r\n\r\n1. 为了避免列表出现上述**重新计数**问题，写列表时请**直接将项目内容直接紧跟在其表头后**，而不要在表头与其统辖的项目内容之间加入空行。\r\n2. 就目前的实验结果看来，在 Markdown 的 GitHub 实现中，只要代码符合第 1 点，就不会出现列表缩进问题；而在 MarkdownPad 2 实现中，为了避免出现上述的列表下缩进问题，请在第 n 个列表项目内容尾部、第 n+1 个列表项目序号之间加入一个空行。\r\n\r\n\r\n## Q2 列表与正文粘在一起 ##\r\n\r\n### 表现 ###\r\n\r\n比如说我本想在这段话后跟上一个列表，却出现这种状况：\r\n1. 列表1\r\n2. 列表2\r\n3. 列表3\r\n\r\n### 概述 ###\r\n\r\n这里的问题是：\r\n\r\n1. 列表与正文粘在一起了，没有与正文独立开来\r\n\r\n\r\n### 分析 ###\r\n\r\n造成问题的原始代码如下：\r\n\r\n`比如说我本想在这段话后跟上一个列表，却出现这种状况：` \r\n`1. 列表1`\r\n`2. 列表2`\r\n`3. 列表3`\r\n\r\n注意到原始代码中列表与正文之间**只有一个换行符**\r\n\r\n### 尝试1 ###\r\n\r\n考虑到[《如何在 markdown 语法下键入换行符》](https://github.com/OpenMindClub/OMOOC.py/issues/9)一文中提到了：\r\n\r\n\r\n> 写作者必须键入**2个连续的**`空格`之后再按`Enter`，才能完成`强制换行`这个动作\r\n \r\n那么在正文与列表之间加入两个连续的空格是看看，即当代码是这样的时候（1个[Space]表示此处有1个空格）：\r\n\r\n`比如说我本想在这段话后跟上一个列表，却出现这种状况：[Space][Space]`\r\n`1. 列表1`\r\n`2. 列表2`\r\n`3. 列表3`  \r\n\r\n显示效果是：  \r\n\r\n比如说我本想在这段话后跟上一个列表，却出现这种状况：  \r\n1. 列表1\r\n2. 列表2\r\n3. 列表3\r\n\r\n看来问题没有得到实质性的解决：markdown 没有把代码识别为列表，而是认为这串代码是正文。\r\n\r\n### 尝试2 ###\r\n\r\n显然不能考虑在每个列表的表头后插入两个空格，因为这样仅仅是将代码视为正文来处理，没有解决实质性问题。  \r\n那么我们不妨在列表最前面与正文之间再插入一个空行，即当代码是这样的时候（[Newline]表示此处键入 1 个换行符，即1个`Enter`）：\r\n\r\n`比如说我本想在这段话后跟上一个列表，却出现这种状况：` \r\n`[Newline]`\r\n`1. 列表1`\r\n`2. 列表2`\r\n`3. 列表3`\r\n\r\n显示效果是：  \r\n\r\n比如说我本想在这段话后跟上一个列表，却出现这种状况：  \r\n\r\n1. 列表1\r\n2. 列表2\r\n3. 列表3\r\n\r\n问题好像得到解决了？再向表头下面添加项目试试看：\r\n\r\n比如说我本想在这段话后跟上一个列表，却出现这种状况：  \r\n\r\n1. 列表1\r\n 1. 项目1.1\r\n 2. 项目1.2\r\n2. 列表2\r\n 1. 项目2.1\r\n 2. 项目2.2\r\n3. 列表3\r\n 1. 项目3.1\r\n 2. 项目3.2\r\n\r\n非常好，问题得到了圆满解决。\r\n\r\n### A2 解决 ###\r\n\r\n综上所述：\r\n为了让 markdown 能识别出列表，应在正文与列表之间插入一个空行，亦即两个换行符（键入2个`Enter`）。"}}