Un lenguaje de marcado ligero ( LML ), también denominado lenguaje de marcado simple o humano , es un lenguaje de marcado con una sintaxis simple y discreta . Está diseñado para que sea fácil de escribir usando cualquier editor de texto genérico y fácil de leer en su forma original. Los lenguajes de marcado ligeros se utilizan en aplicaciones en las que puede ser necesario leer el documento sin procesar, así como la salida renderizada final.
Por ejemplo, una persona que descarga una biblioteca de software puede preferir leer la documentación en un editor de texto en lugar de un navegador web. Otra aplicación para estos lenguajes es proporcionar entrada de datos en publicaciones basadas en la web , como weblogs y wikis , donde la interfaz de entrada es un cuadro de texto simple . Luego, el software del servidor convierte la entrada en un lenguaje de marcado de documentos común como HTML .
Historia
Los lenguajes de marcado ligeros se utilizaron originalmente en pantallas de solo texto que no podían mostrar caracteres en cursiva o negrita , por lo que se tuvieron que desarrollar métodos informales para transmitir esta información. Esta elección de formato se llevó naturalmente a las comunicaciones por correo electrónico de texto sin formato. Los navegadores de consola también pueden recurrir a convenciones de visualización similares.
En 1986, el estándar internacional SGML proporcionó facilidades para definir y analizar lenguajes de marcado ligeros utilizando gramáticas e implicaciones de etiquetas. El XML de W3C de 1998 es un perfil de SGML que omite estas funciones. Sin embargo, no se conoce ninguna definición de tipo de documento SGML (DTD) para ninguno de los idiomas que se enumeran a continuación.
Tipos
Los lenguajes de marcado ligeros se pueden clasificar por sus tipos de etiquetas. Al igual que HTML ( ), algunos lenguajes utilizan elementos con nombre que comparten un formato común para las etiquetas de inicio y finalización (por ejemplo, BBCode ), mientras que los lenguajes de marcado ligeros adecuados están restringidos a ASCII, solo signos de puntuación y otros símbolos que no son letras para las etiquetas, pero algunos también mezclar ambos estilos (por ejemplo, textil ) o permitir HTML incrustado (por ejemplo, Markdown ), posiblemente ampliado con elementos personalizados (por ejemplo, MediaWiki ).bold
[b]bold[/b]
bq.
source
La mayoría de los lenguajes distinguen entre el marcado para líneas o bloques y para tramos de texto más cortos, pero algunos solo admiten el marcado en línea.
Algunos lenguajes de marcado están diseñados para un propósito específico, como documentar el código de computadora (por ejemplo , POD , RD ) o convertirse a un formato de salida determinado (generalmente HTML) y nada más, otros son de aplicación más general. Esto incluye si están orientados a la presentación textual o a la serialización de datos. [ aclaración necesaria ]
Lenguajes orientados presentación incluyen AsciiDoc , ATX , BBCode, criolla , Crossmark, Epytext , Haml , JsonML , makedoc , de rebajas, el modo Org , POD, reST , RD, setext , SiSU , SPIP , Xupl , Texy! , Textil, txt2tags , UDO y Wikitext .
Los lenguajes orientados a la serialización de datos incluyen Curl (homoicónico, pero también lee JSON; cada objeto se serializa), JSON y YAML .
Comparación de las características del idioma
Idioma | Herramienta de exportación HTML | Herramienta de importación HTML | Mesas | Títulos de enlaces | class atributo | id atributo | Fecha de lanzamiento |
---|---|---|---|---|---|---|---|
AsciiDoc | sí | sí | sí | sí | sí | sí | 2002-11-25 [1] |
BBCode | No | No | sí | No | No | No | 1998 |
criollo | No | No | sí | No | No | No | 2007-07-04 [2] |
Gemtext | sí | ? | No | sí | No | No | 2020 |
Rebajas con sabor a GitHub | sí | No | sí | sí | No | No | 2011-04-28 + |
Notación de formato de Jira | sí | No | sí | sí | No | No | 2002+ [3] |
Reducción | sí | sí | No | sí | Sí No | Sí No | 2004-03-19 [4] [5] |
Markdown extra | sí | sí | Sí [6] | sí | sí | sí | 2013-04-11 [7] |
MediaWiki | sí | sí | sí | sí | sí | sí | 2002 [8] |
MultiMarkdown | sí | No | sí | sí | No | No | 2009-07-13 |
Modo Org | sí | Sí [9] | sí | sí | sí | sí | 2003 [10] |
PmWiki | Sí [11] | sí | sí | sí | sí | sí | 2002-01 |
VAINA | sí | ? | No | sí | ? | ? | 1994 |
reStructuredText | sí | Sí [9] | sí | sí | sí | auto | 2002-04-02 [12] |
Flojo | No | No | No | sí | No | No | 2013+ [13] [14] |
TiddlyWiki | sí | No | sí | sí | sí | No | 2004-09 [15] |
Textil | sí | No | sí | sí | sí | sí | 2002-12-26 [16] |
Texy | sí | sí | sí | sí | sí | sí | 2004 [17] |
txt2tags | sí | Sí [18] | Sí [19] | sí | Sí No | Sí No | 2001-07-26 [20] |
No | No | No | No | No | No | 2016-03-16 [21] |
La propia sintaxis de Markdown no admite atributos de clase o atributos de identificación; sin embargo, dado que Markdown admite la inclusión de código HTML nativo, estas características se pueden implementar utilizando HTML directo. (Algunas extensiones pueden admitir estas funciones).
La propia sintaxis de txt2tags no admite atributos de clase o atributos de identificación; sin embargo, dado que txt2tags admite la inclusión de código HTML nativo en áreas etiquetadas, estas características se pueden implementar usando HTML directo al guardar en un destino HTML. [22]
Comparación de características de implementación
Idioma | Implementaciones | X HTML | Con / La TeX | DocBook | ODF | EPUB | DOC (X) | LML | Otro | Licencia | |
---|---|---|---|---|---|---|---|---|---|---|---|
AsciiDoc | Python , Ruby , JavaScript , Java | XHTML | Látex | DocBook | ODF | EPUB | No | - | Página de manual, etc. | GNU GPL, MIT | |
BBCode | Perl , PHP , C # , Python , Ruby | (X) HTML | No | No | No | No | No | No | - | - | Dominio publico |
criollo | PHP , Python , Ruby , JavaScript [23] | Depende de la implementación | CC_BY-SA 1.0 | ||||||||
Rebajas con sabor a GitHub | Haskell ( Pandoc ) | HTML | LaTeX, ConTeXt | DocBook | ODF | EPUB | DOC | AsciiDoc , reST | OPML | GPL | |
Java , [24] JavaScript , [25] [26] [27] PHP , [28] [29] Python , [30] Ruby [31] | HTML [25] [26] [27] [29] [30] | No | No | No | No | No | No | - | - | Propiedad | |
Reducción | Perl (originalmente), C , [32] [33] Python , [34] JavaScript , Haskell , [9] Ruby , [35] C # , Java , PHP | HTML | LaTeX, ConTeXt | DocBook | ODF | EPUB | RTF | MediaWiki , reST | Página de manual , S5 , etc. | Estilo BSD y GPL (ambos) | |
Markdown extra | PHP (originalmente), Python , Ruby | XHTML | No | No | No | No | No | No | - | - | Estilo BSD y GPL (ambos) |
MediaWiki | Perl , PHP , Haskell , Python | XHTML | No | No | No | No | No | No | - | - | GNU GPL |
MultiMarkdown | C , Perl | (X) HTML | Látex | No | ODF | No | DOC, RTF | - | OPML | GPL , MIT | |
Modo Org | Emacs Lisp , Ruby (solo analizador), Perl , OCaml | XHTML | Látex | DocBook | ODF | EPUB [36] | DOCX [36] | Reducción | TXT , XOXO , iCalendar , Texinfo , man , contrib: groff , s5 , deck.js, Confluence Wiki Markup, [37] TaskJuggler , RSS , FreeMind | GPL | |
PmWiki | PHP | XHTML 1.0 Transicional, HTML5 | No | Complementos de exportación de PDF | No | No | Complemento de exportación EPUB | No | - | - | GNU GPL |
VAINA | Perl | (X) HTML, XML | Látex | DocBook | No | No | RTF | - | Página de manual , texto sin formato | Licencia artística , licencia de Perl | |
reStructuredText | Python , [38] [39] Haskell (Pandoc) , Java , | HTML, XML | Látex | DocBook | ODF | EPUB | DOC | - | man , S5 , Devhelp , QT Help , CHM , JSON | Dominio publico | |
Textil | PHP , JavaScript , Java , Perl , Python , Ruby , ASP , C # , Haskell | XHTML | No | No | No | No | No | No | - | - | Licencia textil |
¡Texy! | PHP , C # | (X) HTML | No | No | No | No | No | No | - | - | Licencia GNU GPL v2 |
txt2tags | Python , [40] PHP [41] | (X) HTML, SGML | Látex | DocBook | ODF | EPUB | DOC | Criollo , AsciiDoc , MediaWiki , MoinMoin , PmWiki , DokuWiki , Google Code Wiki | roff , hombre , MagicPoint , Lout , PageMaker , Arte ASCII , TXT | GPL |
Comparación de la sintaxis del lenguaje de marcado ligero
Sintaxis de tramo en línea
Aunque generalmente se documenta como texto en cursiva y negrita, la mayoría de los procesadores de marcado livianos generan elementos HTML semánticos em
y en su strong
lugar. El texto monoespaciado puede resultar en elementos semánticos code
o de presentación tt
. Pocos idiomas hacen una distinción, por ejemplo, textil, o permiten al usuario configurar la salida fácilmente, por ejemplo, Texy.
Los LML a veces difieren para el marcado de varias palabras, donde algunos requieren que los caracteres de marcado reemplacen los espacios entre palabras ( infijo ). Algunos idiomas requieren un solo carácter como prefijo y sufijo, otros necesitan duplicados o incluso triplicados o admiten ambos con un significado ligeramente diferente, por ejemplo, diferentes niveles de énfasis.
Salida HTML | strongly emphasized | emphasized text | | semántico |
---|---|---|---|---|
bold text | italic text | monospace text | presentacional | |
AsciiDoc | *bold text* | 'italic text' | +monospace text+ | Puede duplicar operadores para aplicar formato donde no hay límite de palabras (por ejemplo, **b**old t**ex**t produce b old t ex t). |
_italic text_ | `monospace text` | |||
ATX | *bold text* | _italic text_ | |monospace text| | estilo de correo electrónico |
BBCode | [b]bold text[/b] | [i]italic text[/i] | [code]monospace text[/code] | El formateo funciona a través de saltos de línea. |
criollo | **bold text** | //italic text// | {{{monospace text}}} | Las llaves triples son para nowiki, que es opcionalmente monoespaciada. |
Gemtext | N / A | N / A | ```alt text | El texto que sigue inmediatamente a las tres primeras comillas es texto alternativo. |
Notación de formato de Jira | *bold text* | _italic text_ | {{monospace text}} | |
Rebajas [42] | **bold text** | *italic text* | `monospace text` | etiquetas HTML semánticas |
__bold text__ | _italic text_ | |||
MediaWiki | '''bold text''' | ''italic text'' | | en su mayoría recurre a HTML en línea |
Modo Org | *bold text* | /italic text/ | =code= | |
~verbatim~ | ||||
PmWiki | '''bold text''' | ''italic text'' | @@monospace text@@ | |
descansar | **bold text** | *italic text* | ``monospace text`` | |
Setext | **bold text** | ~italic text~ | N / A | |
Textil [43] | *strong* | _emphasis_ | @monospace text@ | etiquetas HTML semánticas |
**bold text** | __italic text__ | etiquetas HTML de presentación | ||
¡Texy! | **bold text** | *italic text* | `monospace text` | etiquetas HTML semánticas por defecto, soporte opcional para etiquetas de presentación |
//italic text// | ||||
TiddlyWiki | ''bold text'' | //italic text// | `monospace text` | |
``monospace text`` | ||||
txt2tags | **bold text** | //italic text// | ``monospace text`` | |
VAINA | B | I | C | El texto sangrado también se muestra como código monoespaciado. |
Flojo | *bold text* | _italic text_ | `monospace text` | ```block of monospaced text``` |
*bold text* | _italic text_ | ```monospace text``` |
Gemtext no tiene ningún formato en línea, el texto monoespaciado (texto preformateado conocido por la comunidad Gemini) debe tener la apertura y el cierre ```
en sus propias líneas.
Sintaxis de énfasis
En HTML, el texto se enfatiza con los tipos de elementos y
, mientras que
y
tradicionalmente marcan el texto en cursiva o negrita, respectivamente.
Microsoft Word y Outlook y, en consecuencia, otros procesadores de texto y clientes de correo que se esfuerzan por lograr una experiencia de usuario similar, admiten la convención básica de usar asteriscos en negrita y guiones bajos en cursiva. Mientras Word elimina los caracteres, Outlook los conserva.
Código | AsciiDoc | ATX | criollo | Jira | Reducción | MediaWiki | Modo Org | PmWiki | descansar | Setext | Flojo | Textil | ¡Texy! | TiddlyWiki | txt2tags | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
*italic* | No | No | No | No | sí | No | No | No | sí | No | No | No | sí | No | No | No |
**italic** | No | No | No | No | No | No | No | No | No | No | No | No | No | No | No | No |
_italic_ | sí | sí | No | sí | sí | No | No | No | No | No | sí | sí | No | No | No | sí |
__italic__ | sí | No | No | No | No | No | No | No | No | No | No | sí | No | No | No | No |
'italic' | sí | No | No | No | No | No | No | No | No | No | No | No | No | No | No | No |
''italic'' | sí | No | No | No | No | sí | No | sí | No | No | No | No | No | No | No | No |
/italic/ | No | No | No | No | No | No | sí | No | No | No | No | No | No | No | No | No |
//italic// | No | No | sí | No | No | No | No | No | No | No | No | No | sí | sí | sí | No |
~italic~ | No | No | No | No | No | No | No | No | No | sí | No | No | No | No | No | No |
Código | AsciiDoc | ATX | criollo | Jira | Reducción | MediaWiki | Modo Org | PmWiki | descansar | Setext | Flojo | Textil | ¡Texy! | TiddlyWiki | txt2tags | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
*bold* | sí | sí | No | sí | No | No | sí | No | No | No | sí | sí | No | No | No | sí |
**bold** | sí | No | sí | No | sí | No | No | No | sí | sí | No | sí | sí | No | sí | No |
__bold__ | No | No | No | No | sí | No | No | No | No | No | No | No | No | No | No | No |
''bold'' | No | No | No | No | No | No | No | No | No | No | No | No | No | sí | No | No |
'''bold''' | No | No | No | No | No | sí | No | sí | No | No | No | No | No | No | No | No |
Sintaxis editorial
En HTML, el texto eliminado o eliminado e insertado se marca con los tipos de elementos
y , respectivamente. Sin embargo, los tipos de elementos heredados
o
y todavía están disponibles para tramos de texto tachados y subrayados.
Código | Jira | Reducción | Modo Org | Setext | TiddlyWiki | txt2tags |
---|---|---|---|---|---|---|
_underline_ | No | Opcional | sí | sí | No | No |
__underline__ | No | Opcional | No | No | sí | sí |
+underline+ | sí | No | No | No | No | No |
AsciiDoc, ATX, Creole, MediaWiki, PmWiki, reST, Slack, Textile, Texy! y WhatsApp no admiten marcado dedicado para subrayar texto.
Código | Jira | Reducción | Modo Org | Flojo | TiddlyWiki | txt2tags | |
---|---|---|---|---|---|---|---|
~stricken~ | No | No | No | sí | No | No | sí |
~~stricken~~ | No | GFM | No | No | sí | No | No |
+stricken+ | No | No | sí | No | No | No | No |
-stricken- | sí | No | No | No | No | No | No |
--stricken-- | No | No | No | No | No | sí | No |
AsciiDoc, ATX, Creole, MediaWiki, PmWiki, reST, Setext, Textile y Texy! no son compatibles con el marcado dedicado para tachar el texto.
Sintaxis de programación
El código de computadora entre comillas se presenta tradicionalmente en fuentes similares a las de una máquina de escribir, donde cada carácter ocupa el mismo ancho fijo. HTML ofrece los tipos de elementos semánticos y de presentación obsoletos
para esta tarea.
Código | AsciiDoc | ATX | criollo | Gemtext | Jira | Reducción | Modo Org | PmWiki | descansar | Flojo | Textil | ¡Texy! | TiddlyWiki | txt2tags | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
@code@ | No | No | No | No | No | No | No | No | No | No | sí | No | No | No | No |
@@code@@ | No | No | No | No | No | No | No | sí | No | No | No | No | No | No | No |
`code` | sí | No | No | No | No | sí | No | No | No | sí | No | sí | sí | No | No |
``code`` | sí | No | No | No | No | sí | No | No | sí | No | No | No | sí | sí | No |
```code``` | No | No | No | sí | No | sí | No | No | No | Sí No | No | No | sí | No | sí |
=code= | No | No | No | No | No | No | sí | No | No | No | No | No | No | No | No |
~code~ | No | No | No | No | No | No | sí | No | No | No | No | No | No | No | No |
+code+ | sí | No | No | No | No | No | No | No | No | No | No | No | No | No | No |
++code++ | sí | No | No | No | No | No | No | No | No | No | No | No | No | No | No |
{{code}} | No | No | No | No | sí | No | No | No | No | No | No | No | No | No | No |
{{{code}}} | No | No | sí | No | No | No | No | No | No | No | No | No | No | No | No |
|code| | No | sí | No | No | No | No | No | No | No | No | No | No | No | No | No |
Mediawiki, Setext y Gemtext no proporcionan un marcado ligero para tramos de código en línea.
Sintaxis de encabezado
Los títulos suelen estar disponibles en hasta seis niveles, pero el superior suele reservarse para contener lo mismo que el título del documento, que puede configurarse externamente. Alguna documentación puede asociar niveles con tipos divisionales, por ejemplo, parte, capítulo, sección, artículo o párrafo.
La mayoría de los LML siguen uno de dos estilos para los títulos, ya sea subrayados como Setext o marcadores de línea como atx [44] , o admiten ambos.
Encabezados subrayados
Encabezado de nivel 1===============Encabezado de nivel 2---------------Encabezado de nivel 3~~~~~~~~~~~~~~~
El primer estilo utiliza subrayados, es decir, caracteres repetidos (por ejemplo =
, igual , guión -
o tilde ~
, generalmente al menos dos o cuatro veces) en la línea debajo del texto del encabezado.
Caracteres: | = | - | ~ | * | # | + | ^ | _ | : | " | ' | ` | . | min |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Reducción | 1 | 2 | No | No | No | No | No | No | No | No | No | No | No | 1 |
Setext | 1 | 2 | No | No | No | No | No | No | No | No | No | No | No | ? |
AsciiDoc | 1 | 2 | 3 | No | No | No | No | No | No | No | No | No | No | 2 |
¡Texy! | 3 | 4 | No | 2 | 1 | No | No | No | No | No | No | No | No | 3 |
reStructuredText | sí | sí | sí | sí | sí | sí | sí | sí | sí | sí | sí | sí | sí | ancho del encabezado |
RST determina dinámicamente los niveles de encabezado, lo que hace que la autoría sea más individual por un lado, pero complica las fusiones de fuentes externas por otro lado.
Encabezados prefijados
# Encabezado de nivel 1## Título de nivel 2 ##### Título de nivel 3 ###
El segundo estilo se basa en marcadores repetidos (por ejemplo #
, almohadilla , igual =
o asterisco *
) al comienzo del título en sí, donde el número de repeticiones indica el nivel de título (a veces inverso). La mayoría de los idiomas también admiten la duplicación de los marcadores al final de la línea, pero mientras que algunos los hacen obligatorios, otros ni siquiera esperan que sus números coincidan.
Personaje: | = | # | * | ! | + | Sufijo | Niveles | Sangría |
---|---|---|---|---|---|---|---|---|
AsciiDoc | sí | No | No | No | No | Opcional | 1–6 | No |
ATX | No | sí | No | No | No | No | ilimitado | ? |
criollo | sí | No | No | No | No | Opcional | 1–6 | No |
Gemtext | No | sí | No | No | No | ? | 1-3 | No |
MediaWiki | sí | No | No | No | No | sí | 1–6 | No |
TiddlyWiki | No | No | No | sí | No | No | 1–6 | No |
txt2tags | sí | No | No | No | sí | sí | 1–6 | No |
Reducción | No | sí | No | No | No | Opcional | 1–6 | No |
¡Texy! | sí | sí | No | No | No | Opcional | 6–1 o 1–6, dinámico | No |
Modo Org | No | No | sí | No | No | No | 1– + ∞ | alternativa [45] [46] [47] |
PmWiki | No | No | No | sí | No | Opcional | 1–6 | No |
El modo Org admite la sangría como medio para indicar el nivel.
BBCode no admite títulos de sección en absoluto.
En su lugar, POD y Textile eligen la convención HTML de niveles de encabezado numerados.
Idioma | Formato |
---|---|
VAINA | = head1 Nivel 1 Encabezado= head2 Nivel 2 Encabezado |
Textil , [43] Jira [3] | h1. Encabezado de nivel 1h2. Encabezado de nivel 2h3. Encabezado de nivel 3h4. Encabezado de nivel 4h5. Encabezado de nivel 5h6. Encabezado de nivel 6 |
Microsoft Word admite párrafos con formato automático como encabezados si no contienen más de un puñado de palabras, no hay punto al final y el usuario presiona la tecla Intro dos veces. Para los niveles inferiores, el usuario puede presionar la tecla de tabulación el número de veces que corresponda antes de ingresar el texto, es decir, de una a ocho pestañas para los niveles de encabezado del dos al nueve.
Sintaxis del enlace
Los hipervínculos se pueden agregar en línea, lo que puede saturar el código debido a URL largas, o con referencias alias
numeradas o nombradas id
a líneas que no contienen nada más que la dirección y los atributos relacionados y, a menudo, pueden estar ubicados en cualquier parte del documento. La mayoría de los idiomas permiten al autor especificar el texto Text
que se mostrará en lugar de la dirección simple http://example.com
y algunos también proporcionan métodos para establecer un título de enlace diferente Title
que puede contener más información sobre el destino.
Los LML que están diseñados para configuraciones especiales, por ejemplo, wikis o documentación de código, pueden generar automáticamente anclajes con nombre (para encabezados, funciones, etc.) dentro del documento, vincular a páginas relacionadas (posiblemente en un espacio de nombres diferente) o proporcionar una búsqueda textual de palabras clave vinculadas .
La mayoría de los idiomas emplean corchetes (dobles) cuadrados o angulares para envolver enlaces, pero casi ningún idioma es completamente compatible. Muchos pueden reconocer y analizar automáticamente URL absolutas dentro del texto sin más marcado.
Idiomas | Sintaxis básica | Sintaxis de texto | Sintaxis del título |
---|---|---|---|
BBCode, criollo, MediaWiki, PmWiki | http://example.com | ||
Textil | "Text":http://example.com | "Text (Title)":http://example.com | |
¡Texy! | "Text .(Title)":http://example.com | ||
AsciiDoc | http://example.com[Text] | ||
Flojo |
| ||
TiddlyWiki | [[Text|http://example.com]] | ||
Jira | [http://example.com] | [Text|http://example.com] | |
txt2tags | [Text http://example.com] | ||
MediaWiki | [http://example.com Text] | ||
Criollo, MediaWiki, PmWiki | [[Name]] | [[Name|Text]] | |
Modo Org | [[Name][Text]] | ||
TiddlyWiki | [[Text|Name]] | ||
criollo | [[Namespace:Name]] | [[Namespace:Name|Text]] | |
Modo Org | [[Namespace:Name][Text]] | ||
Criollo, PmWiki | [[http://example.com]] | [[http://example.com|Text]] | |
BBCode | [url]http://example.com[/url] | [url=http://example.com]Text[/url] | |
Reducción | | [Text](http://example.com) | [Text](http://example.com "Title") |
reStructuredText | `Text | ||
VAINA | L | ||
VAINA | L | ||
Gemtext | => gemini://example.com | => gemini://example.com Text |
Los enlaces de Gemtext deben estar en una línea por sí mismos, no se pueden usar en línea.
Idiomas | Sintaxis de texto | Sintaxis del título |
---|---|---|
reStructuredText | … Nombre_… .. _Nombre: http://example.com | |
ATX | … [Texto] …[Texto] http://example.com | |
AsciiDoc | … [[identificación]] …< | … [[identificación]] …<< id, texto >> |
... ancla: id ...xref: id | ... ancla: id ...xref: id [Texto] | |
Reducción | … [ Texto ] [ id ]…[ id ]: http://example.com | … [ Texto ] [ id ]…[ id ]: http://example.com "Título" |
… [ Texto ] []…[ Texto ]: http://example.com | … [ Texto ] []…[ Texto ]: http://example.com "Título" | |
… [Texto] …[ Texto ]: http://example.com | … [Texto] …[ Texto ]: http://example.com "Título" | |
Textil | ... "Texto": alias ...[alias] http://example.com | ... "Texto": alias ...[alias (título)] http://example.com |
¡Texy! | ... "Texto": alias ...[alias]: http://example.com | ... "Texto": alias ...[alias]: http://example.com. (Título) |
La sintaxis de enlace normal de Org-mode realiza una búsqueda de texto del archivo. También puede colocar objetivos dedicados con <
.
Sintaxis de lista
HTML requiere un elemento explícito para la lista, especificando su tipo, y uno para cada elemento de la lista, pero la mayoría de los lenguajes de marcado ligeros solo necesitan diferentes prefijos de línea para las viñetas o elementos enumerados. Algunos idiomas se basan en la sangría para las listas anidadas, otros usan marcadores de lista principal repetidos.
Caracteres: | * | - | + | # | . | · | • | _ | : | – | — | sangrar | saltar | nido |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Reducción | sí | sí | sí | No | No | No | No | No | No | No | No | 0-3 | 1-3 | sangrar |
MediaWiki , TiddlyWiki | sí | No | No | No | No | No | No | No | No | No | No | 0 | 1+ | repetir |
Modo Org | Sí [48] | sí | sí | No | No | No | No | No | No | No | No | 0+ | sangrar | |
Jira | sí | sí | No | No | No | No | No | No | No | No | No | 0 | 1+ | repetir |
Gemtext | sí | No | No | No | No | No | No | No | No | No | No | 0 | 1+ | No |
Microsoft Word convierte automáticamente los párrafos que comienzan con un asterisco *
, un guión menos -
o un corchete mayor que >
seguido de un espacio o tabulador horizontal como elementos de lista de viñetas. También iniciará una lista enumerada para el dígito 1 y las letras que no distinguen entre mayúsculas y minúsculas a (para listas alfabéticas) o i (para números romanos), si van seguidas de un punto .
, un paréntesis de cierre )
, un signo mayor que >
o un guión menos -
y un espacio o tabulación; en el caso del paréntesis redondo, (
también se admite una apertura opcional antes del marcador de lista.
Los idiomas difieren en si admiten dígitos opcionales u obligatorios en los elementos de la lista numerada, qué tipo de enumeradores entienden (por ejemplo, dígito decimal 1 , números romanos i o I , letras alfabéticas a o A ) y si admiten mantener valores explícitos en la salida. formato. Algunos dialectos de Markdown, por ejemplo, respetarán un valor inicial distinto de 1, pero ignorarán cualquier otro valor explícito.
Caracteres: | # | #1 | 1. | 1) | 1] | 1} | (1) | [1] | {1} | a. | A. | i. | I. | sangrar | saltar | nido |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Reducción | No | No | sí | sí | No | No | No | No | No | No | No | No | No | 0-3 | 1-3 | sangrar |
MediaWiki , TiddlyWiki | sí | No | No | No | No | No | No | No | No | No | No | No | No | 0 | 1+ | repetir |
Modo Org | No | No | sí | sí | No | No | No | No | No | Opcional | No | No | 0+ | sangrar | ||
Jira | sí | No | No | No | No | No | No | No | No | No | No | No | No | 0 | 1+ | repetir |
Slack ayuda al usuario a ingresar listas enumeradas y con viñetas, pero en realidad no las formatea como tales, es decir, solo incluye un dígito inicial seguido de un punto y un espacio o un carácter de viñeta •
delante de una línea.
Idiomas | Término que se está definiendo | Definición del término |
---|---|---|
MediaWiki | ; Term | : Definition |
TiddlyWiki | ||
Modo Org | - Term :: Definition |
Ver también
- Lenguaje de programación ligero
- Comparación de lenguajes de marcado de documentos
- Comparación de generadores de documentación
- WikiText
- Reducción
Referencias
- ^ "AsciiDoc ChangeLog" . Consultado el 24 de febrero de 2017 .
- ^ "Versiones de WikiCreole" . Consultado el 24 de febrero de 2017 .
- ^ a b Jira. "Ayuda de notación de formato de texto" . Atlassian . Consultado el 22 de diciembre de 2020 .
- ^ "Markdown" . Aaron Swartz: El Weblog . 2004-03-19.
- ^ "Bola de fuego atrevida: rebaja" . Archivado desde el original el 2 de abril de 2004 . Consultado el 25 de abril de 2014 .
- ^ "PHP Markdown Extra" . Michel Fortin . Consultado el 8 de octubre de 2013 .
- ^ "PHP Markdown: Historia" . Michel Fortin . Consultado el 23 de diciembre de 2020 .
- ^ "Historia de MediaWiki" . Consultado el 24 de febrero de 2017 .
- ^ a b c Pandoc , que está escrito en Haskell , analiza Markdown (en dos formas) y ReStructuredText , así como HTML y LaTeX; escribe desde cualquiera de estos formatos en HTML , RTF , LaTeX , ConTeXt , OpenDocument , EPUB y varios otros formatos, incluido (a través de LaTeX) PDF.
- ^ "Modo Org para Emacs - Tu vida en texto sin formato" . orgmode.org . Equipo OrgMode . Consultado el 9 de diciembre de 2016 .
- ^ "PmWiki Cookbook - Exportar complementos" . Consultado el 7 de enero de 2018 .
- ^ "Una introducción a reStructuredText" . Consultado el 24 de febrero de 2017 .
- ^ "Centro de ayuda de Slack> Uso de Slack> Enviar mensajes> Dar formato a sus mensajes" . Consultado el 7 de agosto de 2018 .
- ^ "Documentación de la API de Slack: formato de mensaje básico" . Consultado el 7 de agosto de 2018 .
- ^ "Historia de TiddlyWiki" . tiddlywiki.com .
- ^ "Textismo› Herramientas ›Textil" . textism.com . Archivado desde el original el 26 de diciembre de 2002.
- ^ "Qué es Texy" . Consultado el 24 de febrero de 2017 .
- ^ "Módulo txt2tags Html2wiki" . cpan.org . Consultado el 30 de enero de 2014 .
- ^ "Guía del usuario de Txt2tags" . Txt2tags.org . Consultado el 24 de febrero de 2017 .
- ^ "registro de cambios de txt2tags" . Consultado el 24 de febrero de 2017 .
- ^ "Preguntas frecuentes de WhatsApp: formatear sus mensajes" . Consultado el 21 de noviembre de 2017 .
- ^ "Guía del usuario de Txt2tags" . Txt2tags.org . Consultado el 24 de febrero de 2017 .
- ^ "Convertidores" . WikiCreole . Consultado el 8 de octubre de 2013 .
- ^ pegdown : una biblioteca de Java para el procesamiento de Markdown
- ^ a b gfms : Servidor de rebajas con sabor a Github
- ^ a b marcado : Un analizador y compilador de rebajas con todas las funciones, escrito en JavaScript. Construido para la velocidad.
- ^ a b node-gfm : convertidor de rebajas a HTML con sabor de GitHub
- ^ Parsedown : analizador de Markdown escrito en PHP
- ^ a b Ciconia : analizador de Markdown escrito en PHP
- ^ a b Grip : Vista previa instantánea Léame de GitHub
- ^ github-markdown : analizador de Markdown autónomo para GitHub
- ^ PEG-rebaja es una implementación de la reducción del precio en C .
- ^ Descuento es también una implementación de rebajas en C .
- ^ "Python-Markdown" . Github.com . Consultado el 8 de octubre de 2013 .
- ^ Bruce Williams < http://codefluency.com >, para Ruby Central < http://rubycentral.org >. "kramdown: información del proyecto" . RubyForge. Archivado desde el original el 7 de agosto de 2013 . Consultado el 8 de octubre de 2013 .
- ^ a b "Vía ox-pandoc y el propio pandoc" .
- ^ Atlassian. "Editor de Confluence 4.0 - Qué ha cambiado para los usuarios de Wiki Markup (Confluence Wiki Markup está muerto)" . Consultado el 28 de marzo de 2018 .
- ^ Docutils es una implementación de ReStructuredText en Python
- ^ Sphinx es una implementación de ReStructuredText en Python y Docutils con varios constructores de formatos de salida
- ^ Aurelio Jargas www.aurelio.net (11 de enero de 2012). "txt2tags" . txt2tags . Consultado el 8 de octubre de 2013 .
- ^ "txt2tags.class.php - convertidor en línea [sic]" . Txt2tags.org . Consultado el 8 de octubre de 2013 .
- ^ "Sintaxis de Markdown" . Daringfireball.net . Consultado el 8 de octubre de 2013 .
- ^ a b Textile Syntax Archivado el 12 de agosto de 2010 en la Wayback Machine.
- ^ "atx, el verdadero formato de texto estructurado" por Aaron Swartz (2002)
- ^ "El manual de la organización: sección" Una vista de esquema más limpia " " . Consultado el 14 de junio de 2020 .
- ^ "usando org-adapt-indentation" .
- ^ "usando org-indent-mode o org-indent" .
- ^ Nota a pie de página en el manual oficial "Cuando se usa '*' como viñeta, las líneas deben estar sangradas para que no se interpreten como titulares. Además, cuando oculte las estrellas iniciales para obtener una vista de contorno limpia, los elementos de la lista sin formato que comiencen con una estrella puede ser difícil de distinguir de los titulares verdaderos. En resumen: aunque se admite '*', puede ser mejor no usarlo para elementos de listas simples ".
enlaces externos
- Lista de C2
- Curl Markup para reemplazar HTML + CSS + JS
- Habitantes de la ecosfera de autor
- Lista en el sitio web de otl
- Formatos de texto humanitarios: una comparación (obsoleta)
- Pandoc: un versátil conversor de formatos