**正文**
《CommonMark规范中文翻译》项目是一个致力于将CommonMark规范翻译成中文的重要资源，旨在帮助中文读者更好地理解和应用Markdown这一轻量级标记语言。Markdown由于其简洁易读的特性，广泛应用于编写文档、博客、论坛等场景，而CommonMark则是一个旨在统一Markdown解析的开放标准。
Markdown最初由约翰·格鲁伯(John Gruber)和亚伦·斯沃茨(Aaron Swartz)创建，其目的是提供一种易于阅读和写作的文本格式，同时能够方便地转换为HTML。然而，随着Markdown的流行，不同的实现产生了语法差异，导致了兼容性问题。为了解决这个问题，CommonMark应运而生。CommonMark是一个社区驱动的项目，目标是创建一个清晰、一致、可预测的Markdown解析标准，确保在各种平台和工具中，Markdown文档的解析结果具有一致性。
《CommonMark规范中文翻译》项目的核心内容是对`spec.txt`进行翻译，这是一个详细描述CommonMark语法和行为的原始文档。翻译工作完成后，会依据项目说明将文本转换成HTML格式，这样便于在线阅读和分享。HTML版本通常命名为`spec.html`，并部署到`gh-page`分支，这意味着可以在GitHub Pages上查看这个翻译完成的规范，使得用户可以更便捷地访问和学习。
CommonMark规范涵盖了Markdown的基本元素，如标题、段落、引用、代码块、列表、链接、图像、强调、硬换行等，并对每种元素的解析规则做了明确的规定。例如，通过在文字前后添加一个或多个星号或下划线来表示加粗和斜体，用两个破折号或尖括号包裹内容来创建引用和代码块，用井号开头的行创建不同级别的标题，以及使用[文字](链接地址)格式创建链接。
在Markdown的实践中，有一些高级特性也在CommonMark中得到了支持，比如表格、脚注和自动链接。表格允许用户在Markdown文档中创建结构化的数据；脚注为文档提供了注解功能，而自动链接则能自动识别URL并将其转化为超链接。
翻译后的`spec.html`不仅方便了中文用户学习CommonMark，还对开发人员和Markdown工具的作者有极大的价值。他们可以参考这个规范来改进自己的Markdown解析器，确保其遵循CommonMark标准，从而提高兼容性和用户体验。
《CommonMark规范中文翻译》是一项重要的开源工作，它为中文用户打开了通向Markdown标准的大门，促进了Markdown在中文社区的普及和规范化使用。无论是新手还是经验丰富的Markdown用户，都能从中受益，提升自己的文档撰写效率和质量。
2025-05-10 11:17:57
32KB
1
降价
Markdown解析器做对了。 快速且易于扩展。
遵循+添加语法扩展和语法（URL自动链接，印刷者）。
可配置语法！ 您可以添加新规则，甚至替换现有规则。
高速。
默认为。
npm上由社区编写的和。
表中的内容
安装
node.js ：
npm install markdown-it --save
浏览器（CDN）：
用法示例
也可以看看：
-有关更多信息和示例。
-适用于插件编写者。
简单
// node.js, "classic" way:
var MarkdownIt = require ( 'markdown-it' ) ,
md = new MarkdownIt ( ) ;
var result = md . render ( '# markdown-it rulezz!' ) ;
// node.js, the same, but with sugar:
var md = require ( 'markdown-it' ) ( ) ;
var result = md . render ( '# markdown-it rulezz!'
2022-07-11 11:18:18
302KB
1