号外,码云 Markdown 解析器更换为 CommonMark 解析器

码云 CommonMark 解析器

之前码云的解析器基于用户的反馈做了很多定制化的修改。

但是随着使用码云的用户越来越多,以及越来越多的Github用户往码云上迁移,我们收到了很多用户反馈。

始料不及,在Github正常解析渲染的Readme在码云上渲染出来的结果却有所出入。

讨论再三,我们决定将码云的 Markdown 解析器更换为 CommonMark。

更改后的差异如下。

01

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

02

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

03

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

04

解决Readme中注释显示的问题

05

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

06

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

07

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

08

支持--构建表格

09

不再支持[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

具体规则如下:

  • 有osc标示优先 如Readme.osc.md
  • 其次对应语言优先 简体中文[zh CH cn zh-cn zh_cn] 繁体中文 [zh-hk zh-tw zh-yue zh_hk zh_tw zh_yue] 英文 [en] 如 Readme.zh.md
  • 没有以上规则以后缀优先 [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/

原文发布于微信公众号 - 码云Gitee(mayunOSC)

原文发表时间:2017-08-14

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏Laoqi's Linux运维专列

大白话Docker入门(一)

1813
来自专栏王二麻子IT技术交流园地

《跟我学IDEA》一、下载安装idea,设置背景字体编码,配置JDK

写在前面的话: 作为一个在IT界摸爬滚打6年+的老程序员,我属于会的东西多而杂,但是没有任何一样精通的。曾经自己也认真过,蹉跎过,最近和别的同事朋友聊天时,突然...

2518
来自专栏编程坑太多

『中级篇』Kubenetes简介(60)

PS:了解我的老铁都知道,概念讲的少,更多重在实践,通过实践更好的理解概念,从下次开始怼k8s的环境和集群。如果跟我一起学的老铁,应该可以感受的到,在学习doc...

2273
来自专栏Java工程师日常干货

docker化你的java应用(上)前言走进docker

在各种技术大会(互联网架构,云计算等等),哪都少不了docker的身影。docker为啥这么火?因为它解决了大部分企业的痛点:快速的持续集成,服务的弹性伸缩,部...

1111
来自专栏大魏分享(微信公众号:david-share)

世上最强版本Openshift之初体验

横向比较,Openshift在全球IT圈内,Forrester最新的报告认为从技术表现和市场表现看,Openshift 3.10是业内最好的容器云平台。

7962
来自专栏技术翻译

Kubernetes扩展容器架构的7 个工具

Kubernetes是最初由Google开发的容器编排工具,已成为敏捷和DevOps团队的重要资源。作为一个开源工具,Kubernetes本身正在成为一个生态系...

1194
来自专栏Debian社区

OpenStack 基金会发布新容器项目 Kata

OpenStack 基金会发布了一个新的容器项目,叫作 Kata 容器 ,以英特尔的 Clear 容器和 Hyper 的 runV 项目为基础。Kata 容器兼...

1033
来自专栏我是攻城师

8 个你可能不知道的 Docker 知识

2933
来自专栏云计算D1net

8个你可能不知道的Docker知识

自从上世纪 90 年代硬件虚拟化被主流的技术广泛普及之后,对数据中心而言,发生的最大的变革莫过于容器和容器管理工具,例如:Docker。在过去的一年内,Dock...

3705
来自专栏bdcn

CoreOS那些事之Rkt容器尝鲜(上) 转

从CoreOS发布Rocket应用容器项目到现在,已经过去半年时间了。为了增加辨识度,项目更名为了Rkt。在沉寂了许久后,最近又开始在社区里出现了一些新鲜的声音...

3552

扫码关注云+社区

领取腾讯云代金券