jgm/CommonMark
CommonMark
CommonMark es una especificación estándar formal para Markdown, que proporciona una implementación de referencia y un conjunto de reglas para asegurar un renderizado de texto consistente en diferentes plataformas. Consiste en una implementación de parser de Markdown y un sistema para generar documentación de sintaxis formal.
El proyecto incluye un conjunto de pruebas de conformidad integral con más de quinientos ejemplos incrustados para verificar que otras implementaciones de Markdown se adhieran a la especificación. Proporciona herramientas para exportar estos casos de prueba en formato JSON para su uso en procesos de verificación externos.
El sistema cubre la conversión de formatos de documentos, transformando la especificación formal en salidas HTML y PDF legibles por humanos. Emplea un enfoque estructurado para el procesamiento de texto mediante tokenización de una sola pasada y estandarización de sintaxis basada en reglas.
Features
- Markup Syntax Standardization - Provides a rationalized set of formatting rules to ensure consistent document rendering across all platforms.
- Specification-Based Parsers - Implements a reference parser that strictly adheres to the formal CommonMark grammar and rules.
- Markdown Parsers - Implements a tool that converts Markdown formatted text into a structured format based on a standardized specification.
- Parser Conformance Testing - Verifies that a custom Markdown implementation adheres to official specifications using a comprehensive suite of conformance tests.
- Markdown AST Parsing - Converts raw Markdown text into a structured format based on a standardized specification.
- Syntax Standardization Rules - Enforces a consistent interpretation of ambiguous formatting through a rationalized set of priority and nesting rules.
- Language Standard Specifications - Provides the formal set of rules and reference implementation used to ensure consistent rendering of Markdown text across all platforms.
- Markup Specification Test Suites - Provides a collection of over five hundred embedded examples used to verify adherence to the standard specification.
- Specification Conformance Validation - Provides a comprehensive suite of tests to verify that Markdown implementations adhere to the formal specification.
- Document Format Conversions - Transforms specification documents into accessible, human-readable formats like HTML and PDF.
- Multi-Format Generators - Transforms the formal syntax specification into multiple distribution formats including HTML and PDF.
- Specification Documentation Generators - Builds formal syntax documentation into human-readable HTML and PDF formats.
- Specification Document Renderers - Converts the formal syntax specification into HTML and PDF formats for human readability.
- Conformance Data Exports - Extracts raw conformance test cases from the specification in JSON format for external testing tools.
- Single-Pass Tokenizers - Processes input text in a linear sequence to identify formatting markers before structural assembly.
- Conformance Test Case Exports - Exports internal specification test cases into JSON format for use by external language implementations.
- Markdown Specifications - Reference implementation and specification for the CommonMark standard.
- Writing and Documentation - Specification for a standardized and rationalized Markdown syntax.
