代码拉取完成,页面将自动刷新
建议 markdown 支持 [TOC] 或者其他有效的自动目录设计
gitee 帮助文档中以 [TOC] 非标为由拒绝支持自动目录,然而这个理由是不成立的(后面会详细说明)。
只要稍微长一点的 README,目录对于阅读者而言是非常有的效率
而 [TOC] 对于有目录需要的 markdown 编写者同样也是有极大效率提升的
使用 A 标签也是非标的,因为原生 Markdown 根本就没有定义过内链标签,而且 A 标签需要依靠自己写脚本或者完全人工维护,非常不方便
用户的不便当然可以用户自己解决,但是这也是产品设计可以认真设计的东西
markdown 没有严格的所谓“标准”,只有一份大家自愿遵守的创始人标准:
https://daringfireball.net/projects/markdown/syntax
对比这个“标准”,几乎所有社区实现都是超纲的,例如各种社区实现普遍支持的表格语法:
title0 | title1 -------|------- cell0 | cell1 cell0 | cell1
title0 | title1 |
---|---|
cell0 | cell1 |
cell0 | cell1 |
在 John Gruber 原始设计中是要求用内联 HTML 标签实现的
作为用户的我自己
附议。写文档的实在是个新手,居然写【非标准】这种东西,哈哈哈哈。
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。
登录 后才可以发表评论