码云 Markdown 解析器更换为 CommonMark 解析器 - 开源中国社区
码云 Markdown 解析器更换为 CommonMark 解析器
Zoker 2017年08月09日

码云 Markdown 解析器更换为 CommonMark 解析器

Zoker Zoker 发布于2017年08月09日 收藏 26

有免费的MySQL,为什么还要买? >>>  

之前码云的解析器基于用户的反馈做了很多定制化的修改,但是随着使用码云的用户越来越多,以及越来越多的Github用户往码云上迁移,我们收到了很多用户反馈,在Github正常解析渲染的Readme在码云上渲染出来的结果却有所出入,讨论再三,我们决定将码云的 Markdown 解析器更换为 CommonMark。

更改后的差异如下:

标题#后面需要有空格才会正确渲染标题

输入图片说明

正确解析形如 Map<String, Collection<Object.toString>> 的文本

输入图片说明

解决代码块标签前后没有空行导致不换行显示

输入图片说明

解决Readme中注释显示的问题

输入图片说明

解决 Html colspan、rowspan 标签无效的问题

输入图片说明

解决标题中不支持Code块的问题

输入图片说明

解决内容中不留空格无法加粗的问题

输入图片说明

支持--构建表格

输入图片说明

不再支持[TOC]

标准的Markdown是不支持[TOC]标签的,可以通过a标签的方式自行创建目录

输入图片说明

码云上Readme后缀说明

码云为了适应不同种类的开源项目的Readme显示,有不同的优先显示规则,如下:

 如一个项目有Readme.osc.md 也有 Readme.md,那么在码云上则优先显示 Readme.osc.md 

再比如一个项目有Readme.zh-CN.md 又有 Readme.en.md 如果浏览器是英文,则显示Readme.en.md,如果浏览器是中文,则显示 Readme.zh-CN.md

具体规则如下:

  1. 有osc标示优先 如Readme.osc.md

  2. 其次对应语言优先 简体中文[zh CH cn zh-cn zh_cn] 繁体中文 [zh-hk zh-tw zh-yue zh_hk zh_tw zh_yue] 英文 [en] 如 Readme.zh.md

  3. 没有以上规则以后缀优先 [mdown md mkdn mdwn markdown textile rdoc creole mediawiki rst rest adoc asciidoc pod org txt html htm] 如readme.mdown

如果您在使用中遇到问题,欢迎反馈 https://gitee.com/oschina/git-osc/issues/new

附 CommonMark 语法文档 http://commonmark.org/help/

本站文章除注明转载外,均为本站原创或编译。欢迎任何形式的转载,但请务必注明出处,尊重他人劳动共创开源社区。
转载请注明:文章转载自 开源中国社区 [http://www.oschina.net]
本文标题:码云 Markdown 解析器更换为 CommonMark 解析器
分享
评论(23)
精彩评论
4
社区博客也跟着一起换。。。
1
支持
1
棒棒哒
1
支持~
最新评论
0
表格居中不支持,编辑时预览是好的,提交后查看就变成左对齐了。:persevere:
0
终于打算改了吗,我反映完全不支持html时,还被喷了,说我不懂makedown。。。:joy:
0
统一是好事
0
很好啊,早就该这样了。
还有,顺便把主站的【收藏】功能修复一下把,
每次点收藏,要等到日落!
0
catroll 是什么函数?不是我的用户名么?:stuck_out_tongue:
0
[TOC] 是个好东西,不知道“标准的Markdown”为什么不支持啊
0
赞��
0
0

引用来自“首席的哥队长”的评论

[TOC],不考虑前端弄个js来实现么?
@首席的哥队长 不是每个人都需要啊
0
我说怎么标题不显示了
0
好评,终于统一了
0
其实我推荐 Markdown-IT,也就是 VSCode 用的 Markdown Parser。
https://github.com/markdown-it/markdown-it
0
棒棒的
0
[TOC],不考虑前端弄个js来实现么?
0
还我 [TOC] :flushed:
0
表格内容居中的效果貌似还是不行,https://gitee.com/pyinjava/jtuple
4
社区博客也跟着一起换。。。
0

引用来自“郭大鹏”的评论

osc 和 zh-CN 一起再一个文件名呢?
这种就没有了 :)
0
osc 和 zh-CN 一起再一个文件名呢?
1
支持
顶部