Markdown 编辑器 bug ?

本贴最后更新于 2093 天前,其中的信息可能已经时移世异

在编辑器输入这样的语句

image.png

出来后确实这样的,序号没有继续排列

image.png

相关帖子

被采纳的回答
  • 88250 2

    终于碰到属于我专业领域的问题了....

    先能用就行

    Markdown 文本:

    1. 第一个列表项 ``` 围栏代码块标记 ` 符号要和列表项的第一个非空字符(第字)对齐 ``` 2. 继续第二个列表项

    将渲染为:

    1. 第一个列表项
      围栏代码块标记 ` 符号要和列表项的第一个非空字符(第字)对齐
    2. 继续第二个列表项

    再刨根问底

    这涉及到 Markdown 语法规范(CommonMark)中列表项和围栏代码块的解析。

    首先明确一点:Markdown 会被解析为一颗树,其中列表项是一种块级容器(block container)节点,它可以包含其他的块级(block-level)元素节点。接下来我们了解一下列表项的构成:

    • 开头缩进(本例中缩进为 0,子列表或者放到块引用中才会有缩进)
    • 列表标记:无序列表是 *- 或者 +;有序列表 1 这样的(本例中是 1
    • 分隔符:无序列不需要分隔符;有序列表是 . 或者 )(本例中是 .
    • 内部缩进:分隔符后第一个非空字符之间的空格数(本例中内部缩进为 1
    • 内容(本例中就是 第一个子列表项

    (以上只是大致的规则,还有很多细节规则比如空列表项、用 tab 缩进时如何计算缩进、有序列表开始序号、序号长度等等)

    本案例简单说就是列表项的后续子节点需要和第一个子节点缩进进行对齐,即围栏代码块想要成为项 1 的子节点需要这样写:

    image.png

    (Markdown AST https://spec.commonmark.org/dingus/

    如果代码块缩进没有对齐的话,案例会被分成三个块级元素:列表、代码块、列表:

    image.png

    这就是 CommonMark 规范的意义:能清晰地说明如何处理 Markdown 文本,没有二义性。


    为什么我会知道这些?

    我正在做一款实现 CM、GFM 规范的 Markdown 引擎 —— Lute(预计下个月会将社区的 Markdown 处理切换到该引擎上,等跑一段时间稳定点就正式开源),已经被这些规则折磨两个多月了。你也要成为像我一样专业的 Markdown 程序员吗?请看这份秘籍 😂

欢迎来到这里!

我们正在构建一个小众社区,大家在这里相互信任,以平等 • 自由 • 奔放的价值观进行分享交流。最终,希望大家能够找到与自己志同道合的伙伴,共同成长。

注册 关于
请输入回帖内容 ...
  • 88250 2

    终于碰到属于我专业领域的问题了....

    先能用就行

    Markdown 文本:

    1. 第一个列表项 ``` 围栏代码块标记 ` 符号要和列表项的第一个非空字符(第字)对齐 ``` 2. 继续第二个列表项

    将渲染为:

    1. 第一个列表项
      围栏代码块标记 ` 符号要和列表项的第一个非空字符(第字)对齐
    2. 继续第二个列表项

    再刨根问底

    这涉及到 Markdown 语法规范(CommonMark)中列表项和围栏代码块的解析。

    首先明确一点:Markdown 会被解析为一颗树,其中列表项是一种块级容器(block container)节点,它可以包含其他的块级(block-level)元素节点。接下来我们了解一下列表项的构成:

    • 开头缩进(本例中缩进为 0,子列表或者放到块引用中才会有缩进)
    • 列表标记:无序列表是 *- 或者 +;有序列表 1 这样的(本例中是 1
    • 分隔符:无序列不需要分隔符;有序列表是 . 或者 )(本例中是 .
    • 内部缩进:分隔符后第一个非空字符之间的空格数(本例中内部缩进为 1
    • 内容(本例中就是 第一个子列表项

    (以上只是大致的规则,还有很多细节规则比如空列表项、用 tab 缩进时如何计算缩进、有序列表开始序号、序号长度等等)

    本案例简单说就是列表项的后续子节点需要和第一个子节点缩进进行对齐,即围栏代码块想要成为项 1 的子节点需要这样写:

    image.png

    (Markdown AST https://spec.commonmark.org/dingus/

    如果代码块缩进没有对齐的话,案例会被分成三个块级元素:列表、代码块、列表:

    image.png

    这就是 CommonMark 规范的意义:能清晰地说明如何处理 Markdown 文本,没有二义性。


    为什么我会知道这些?

    我正在做一款实现 CM、GFM 规范的 Markdown 引擎 —— Lute(预计下个月会将社区的 Markdown 处理切换到该引擎上,等跑一段时间稳定点就正式开源),已经被这些规则折磨两个多月了。你也要成为像我一样专业的 Markdown 程序员吗?请看这份秘籍 😂

    1 回复
  • Zephyr via macOS

    Lute 也是 Go 写的么大 D 哥 @88250

    1 回复
  • 88250

    是的,纯 golang 并且没有引入任何第三方库。

    BTW 麻烦楼主结个帖,点下采纳,谢谢!

  • xflash

    你好,Markdown 程序员 D 大 doge 

推荐标签 标签

  • SVN

    SVN 是 Subversion 的简称,是一个开放源代码的版本控制系统,相较于 RCS、CVS,它采用了分支管理系统,它的设计目标就是取代 CVS。

    29 引用 • 98 回帖 • 692 关注
  • 生活

    生活是指人类生存过程中的各项活动的总和,范畴较广,一般指为幸福的意义而存在。生活实际上是对人生的一种诠释。生活包括人类在社会中与自己息息相关的日常活动和心理影射。

    230 引用 • 1454 回帖 • 1 关注
  • 笔记

    好记性不如烂笔头。

    310 引用 • 794 回帖
  • 周末

    星期六到星期天晚,实行五天工作制后,指每周的最后两天。再过几年可能就是三天了。

    14 引用 • 297 回帖 • 1 关注
  • Shell

    Shell 脚本与 Windows/Dos 下的批处理相似,也就是用各类命令预先放入到一个文件中,方便一次性执行的一个程序文件,主要是方便管理员进行设置或者管理用的。但是它比 Windows 下的批处理更强大,比用其他编程程序编辑的程序效率更高,因为它使用了 Linux/Unix 下的命令。

    124 引用 • 74 回帖
  • 锤子科技

    锤子科技(Smartisan)成立于 2012 年 5 月,是一家制造移动互联网终端设备的公司,公司的使命是用完美主义的工匠精神,打造用户体验一流的数码消费类产品(智能手机为主),改善人们的生活质量。

    4 引用 • 31 回帖 • 8 关注
  • CodeMirror
    2 引用 • 17 回帖 • 161 关注
  • 学习

    “梦想从学习开始,事业从实践起步” —— 习近平

    173 引用 • 518 回帖
  • Sublime

    Sublime Text 是一款可以用来写代码、写文章的文本编辑器。支持代码高亮、自动完成,还支持通过插件进行扩展。

    10 引用 • 5 回帖 • 1 关注
  • webpack

    webpack 是一个用于前端开发的模块加载器和打包工具,它能把各种资源,例如 JS、CSS(less/sass)、图片等都作为模块来使用和处理。

    42 引用 • 130 回帖 • 247 关注
  • Outlook
    1 引用 • 5 回帖
  • PostgreSQL

    PostgreSQL 是一款功能强大的企业级数据库系统,在 BSD 开源许可证下发布。

    22 引用 • 22 回帖
  • 服务器

    服务器,也称伺服器,是提供计算服务的设备。由于服务器需要响应服务请求,并进行处理,因此一般来说服务器应具备承担服务并且保障服务的能力。

    125 引用 • 585 回帖 • 1 关注
  • App

    App(应用程序,Application 的缩写)一般指手机软件。

    91 引用 • 384 回帖
  • Vim

    Vim 是类 UNIX 系统文本编辑器 Vi 的加强版本,加入了更多特性来帮助编辑源代码。Vim 的部分增强功能包括文件比较(vimdiff)、语法高亮、全面的帮助系统、本地脚本(Vimscript)和便于选择的可视化模式。

    29 引用 • 66 回帖
  • iOS

    iOS 是由苹果公司开发的移动操作系统,最早于 2007 年 1 月 9 日的 Macworld 大会上公布这个系统,最初是设计给 iPhone 使用的,后来陆续套用到 iPod touch、iPad 以及 Apple TV 等产品上。iOS 与苹果的 Mac OS X 操作系统一样,属于类 Unix 的商业操作系统。

    88 引用 • 139 回帖
  • SQLite

    SQLite 是一个进程内的库,实现了自给自足的、无服务器的、零配置的、事务性的 SQL 数据库引擎。SQLite 是全世界使用最为广泛的数据库引擎。

    5 引用 • 7 回帖
  • TextBundle

    TextBundle 文件格式旨在应用程序之间交换 Markdown 或 Fountain 之类的纯文本文件时,提供更无缝的用户体验。

    1 引用 • 2 回帖 • 82 关注
  • RYMCU

    RYMCU 致力于打造一个即严谨又活泼、专业又不失有趣,为数百万人服务的开源嵌入式知识学习交流平台。

    4 引用 • 6 回帖 • 55 关注
  • Docker

    Docker 是一个开源的应用容器引擎,让开发者可以打包他们的应用以及依赖包到一个可移植的容器中,然后发布到任何流行的操作系统上。容器完全使用沙箱机制,几乎没有性能开销,可以很容易地在机器和数据中心中运行。

    494 引用 • 928 回帖
  • Spark

    Spark 是 UC Berkeley AMP lab 所开源的类 Hadoop MapReduce 的通用并行框架。Spark 拥有 Hadoop MapReduce 所具有的优点;但不同于 MapReduce 的是 Job 中间输出结果可以保存在内存中,从而不再需要读写 HDFS,因此 Spark 能更好地适用于数据挖掘与机器学习等需要迭代的 MapReduce 的算法。

    74 引用 • 46 回帖 • 568 关注
  • OpenCV
    15 引用 • 36 回帖
  • 服务

    提供一个服务绝不仅仅是简单的把硬件和软件累加在一起,它包括了服务的可靠性、服务的标准化、以及对服务的监控、维护、技术支持等。

    41 引用 • 24 回帖 • 4 关注
  • Chrome

    Chrome 又称 Google 浏览器,是一个由谷歌公司开发的网页浏览器。该浏览器是基于其他开源软件所编写,包括 WebKit,目标是提升稳定性、速度和安全性,并创造出简单且有效率的使用者界面。

    63 引用 • 289 回帖 • 2 关注
  • Markdown

    Markdown 是一种轻量级标记语言,用户可使用纯文本编辑器来排版文档,最终通过 Markdown 引擎将文档转换为所需格式(比如 HTML、PDF 等)。

    170 引用 • 1529 回帖
  • Flume

    Flume 是一套分布式的、可靠的,可用于有效地收集、聚合和搬运大量日志数据的服务架构。

    9 引用 • 6 回帖 • 652 关注
  • 钉钉

    钉钉,专为中国企业打造的免费沟通协同多端平台, 阿里巴巴出品。

    15 引用 • 67 回帖 • 289 关注