Langage de balisage léger - Lightweight markup language

Un langage de balisage léger ( LML ), également appelé langage de balisage simple ou humain , est un langage de balisage avec une syntaxe simple et discrète. Il est conçu pour être facile à écrire à l'aide de n'importe quel éditeur de texte générique et facile à lire sous sa forme brute. Les langages de balisage légers sont utilisés dans les applications où il peut être nécessaire de lire le document brut ainsi que la sortie rendue finale.

Par exemple, une personne qui télécharge une bibliothèque de logiciels peut préférer lire la documentation dans un éditeur de texte plutôt que dans un navigateur Web. Une autre application pour ces langages est de permettre la saisie de données dans la publication sur le Web, comme les blogs et les wikis , où l'interface de saisie est une simple zone de texte . Le logiciel serveur convertit ensuite l'entrée en un langage de balisage de document commun comme HTML .

Histoire

Les langages de balisage légers étaient à l'origine utilisés sur des affichages contenant uniquement du texte qui ne pouvaient pas afficher les caractères en italique ou en gras , des méthodes informelles pour transmettre ces informations ont donc dû être développées. Ce choix de formatage a naturellement été appliqué aux communications par courrier électronique en texte brut. Les navigateurs de console peuvent également recourir à des conventions d'affichage similaires.

En 1986, la norme internationale SGML a fourni des fonctionnalités pour définir et analyser des langages de balisage légers à l'aide de grammaires et d'implications de balises. Le XML W3C 1998 est un profil de SGML qui omet ces fonctionnalités. Cependant, aucune définition de type de document SGML (DTD) pour l'un des langages répertoriés ci-dessous n'est connue.

Les types

Les langages de balisage légers peuvent être classés selon leurs types de balises. Comme HTML ( ), certains langages utilisent des éléments nommés qui partagent un format commun pour les balises de début et de fin (par exemple BBCode ), tandis que les langages de balisage légers appropriés sont limités aux signes de ponctuation ASCII uniquement et à d'autres symboles non alphabétiques pour les balises, mais certains aussi mélanger les deux styles (par exemple Textile ) ou autoriser le HTML intégré (par exemple Markdown ), éventuellement étendu avec des éléments personnalisés (par exemple MediaWiki ). <b>bold</b> [b]bold[/b] bq. <ref>source</ref>

La plupart des langages font la distinction entre le balisage pour les lignes ou les blocs et pour les plages de texte plus courtes, mais certains ne prennent en charge que le balisage en ligne.

Certains langages de balisage sont adaptés à un objectif spécifique, comme la documentation de code informatique (par exemple POD , RD ) ou la conversion vers un certain format de sortie (généralement HTML) et rien d'autre, d'autres sont d'application plus générale. Cela inclut s'ils sont orientés sur la présentation textuelle ou sur la sérialisation des données.

Les langages orientés présentation incluent AsciiDoc , atx , BBCode, Creole , Crossmark , Epytext , Haml , JsonML , MakeDoc , Markdown , Org-mode , POD, reST , RD, Setext , SiSU , SPIP , Xupl , Texy ! , Textile, txt2tags , UDO et Wikitext .

Les langages orientés vers la sérialisation des données incluent Curl ( homoiconic , mais lit également JSON ; chaque objet est sérialisé), JSON et YAML .

Comparaison des caractéristiques linguistiques

Comparer les fonctionnalités linguistiques
Langue Outil d'exportation HTML Outil d'importation HTML les tables Titres des liens class attribut id attribut Date de sortie
AsciiDoc Oui Oui Oui Oui Oui Oui 2002-11-25
BBCode Non Non Oui Non Non Non 1998
le créole Non Non Oui Non Non Non 2007-07-04
Gemtext Oui ? Non Oui Non Non 2020
Markdown aromatisé GitHub Oui Non Oui Oui Non Non 2011-04-28+
Notation de formatage Jira Oui Non Oui Oui Non Non 2002+
Réduction Oui Oui Non Oui Oui Non Oui Non 2004-03-19
Réduction supplémentaire Oui Oui Oui Oui Oui Oui 2013-04-11
TexteMarqué Oui Non Oui Non Non Non 2021-01
MediaWiki Oui Oui Oui Oui Oui Oui 2002
MultiMarkdown Oui Non Oui Oui Non Non 2009-07-13
Mode d'organisation Oui Oui Oui Oui Oui Oui 2003
PmWiki Oui Oui Oui Oui Oui Oui 2002-01
COSSE Oui ? Non Oui ? ? 1994
Texterestructuré Oui Oui Oui Oui Oui auto 2002-04-02
Mou Non Non Non Oui Non Non 2013+
TiddlyWiki Oui Non Oui Oui Oui Non 2004-09
Textile Oui Non Oui Oui Oui Oui 2002-12-26
Texy Oui Oui Oui Oui Oui Oui 2004
txt2tags Oui Oui Oui Oui Oui Non Oui Non 2001-07-26
WhatsApp Non Non Non Non Non Non 2016-03-16

La propre syntaxe de Markdown ne prend pas en charge les attributs de classe ou les attributs d'identifiant ; cependant, étant donné que Markdown prend en charge l'inclusion de code HTML natif, ces fonctionnalités peuvent être implémentées à l'aide de HTML direct. (Certaines extensions peuvent prendre en charge ces fonctionnalités.)

La propre syntaxe de txt2tags ne prend pas en charge les attributs de classe ou les attributs d'identifiant ; cependant, étant donné que txt2tags prend en charge l'inclusion de code HTML natif dans les zones balisées, ces fonctionnalités peuvent être implémentées à l'aide de HTML direct lors de l'enregistrement sur une cible HTML.

Comparaison des fonctionnalités de mise en œuvre

Comparer les implémentations, en particulier les formats de sortie
Langue Implémentations X HTML Con / La TeX PDF DocBook FDAL EPUB DOC (X) LML Autre Licence
AsciiDoc Python , Ruby , JavaScript , Java XHTML Latex PDF DocBook FDAL EPUB Non  - Page de manuel, etc. GNU GPL, MIT
BBCode Perl , PHP , C# , Python , Ruby (X)HTML Non Non Non Non Non Non - - Domaine public
le créole PHP , Python , Ruby , JavaScript Dépend de la mise en œuvre CC_BY-SA 1.0
Markdown aromatisé GitHub Haskell ( Pandoc ) HTML LaTeX, ConTeXt PDF DocBook FDAL EPUB DOC AsciiDoc , rest OPML GPL
Java , JavaScript , PHP , Python , Ruby HTML Non Non Non Non Non Non - - Propriétaire
Réduction Perl (à l'origine), C , Python , JavaScript , Haskell , Ruby , C# , Java , PHP HTML LaTeX, ConTeXt PDF DocBook FDAL EPUB RTF MediaWiki , reST Page de manuel , S5 etc. Style BSD et GPL (les deux)
Réduction supplémentaire PHP (à l'origine), Python , Ruby XHTML Non Non Non Non Non Non - - Style BSD et GPL (les deux)
TexteMarqué Manuscrit XHTML Non Non Non Non Non Non - - MIT
MediaWiki Perl , PHP , Haskell , Python XHTML Non Non Non Non Non Non - - GNU GPL
MultiMarkdown C , Perl (X)HTML Latex PDF Non FDAL Non DOC, RTF - OPML GPL , MIT
Mode d'organisation Emacs Lisp , Ruby (analyseur uniquement), Perl , OCaml XHTML Latex PDF DocBook FDAL EPUB DOCX Réduction TXT , XOXO , iCalendar , Texinfo , man , contrib: groff , s5 , deck.js, Confluence Wiki Markup, TaskJuggler , RSS , FreeMind GPL
PmWiki PHP XHTML 1.0 Transitionnel, HTML5 Non Modules d'exportation PDF Non Non Module complémentaire d'exportation EPUB Non - - GNU GPL
COSSE Perl (X)HTML, XML Latex PDF DocBook Non Non RTF - Page de manuel , texte brut Licence Artistique , Licence Perl
Texterestructuré Python , Haskell (Pandoc) , Java , HTML, XML Latex PDF DocBook FDAL EPUB DOC - homme , S5 , Devhelp , Aide QT , CHM , JSON Domaine public
Textile PHP , JavaScript , Java , Perl , Python , Ruby , ASP , C# , Haskell XHTML Non Non Non Non Non Non - - Licence textile
Texy ! PHP , C# (X)HTML Non Non Non Non Non Non - - Licence GNU GPL v2
txt2tags Python , PHP (X)HTML, SGML Latex PDF DocBook FDAL EPUB DOC Créole , AsciiDoc , MediaWiki , MoinMoin , PmWiki , DokuWiki , Google Code Wiki roff , homme , MagicPoint , Lout , PageMaker , Art ASCII , TXT GPL

Comparaison de la syntaxe du langage de balisage léger

Syntaxe d'étendue en ligne

Bien que généralement documenté comme donnant texte en italique et en gras, la plupart des éléments HTML sémantique légère de sortie des processeurs de balisage emet au stronglieu. Le texte à espacement fixe peut entraîner des éléments sémantiques codeou de présentation tt. Peu de langages font une distinction, par exemple Textile, ou permettent à l'utilisateur de configurer facilement la sortie, par exemple Texy.

Les LML diffèrent parfois pour le balisage multi-mots où certains nécessitent les caractères de balisage pour remplacer les espaces inter-mots ( infix ). Certaines langues nécessitent un seul caractère comme préfixe et suffixe, d'autres nécessitent des caractères doublés ou même triplés ou prennent en charge les deux avec une signification légèrement différente, par exemple des niveaux d'accentuation différents.

Comparaison de la syntaxe de formatage de texte
Sortie HTML <strong>strongly emphasized</strong> <em>emphasized text</em> <code>code</code> sémantique
<b>bold text</b> <i>italic text</i> <tt>monospace text</tt> présentation
AsciiDoc *bold text* 'italic text' +monospace text+ Peut doubler les opérateurs pour appliquer le formatage où il n'y a pas de mot (par exemple , les **b**old t**ex**trendements b vieux t ex t).
_italic text_ `monospace text`
ATX *bold text* _italic text_ |monospace text| style de courrier électronique
BBCode [b]bold text[/b] [i]italic text[/i] [code]monospace text[/code] Le formatage fonctionne à travers les sauts de ligne.
le créole **bold text** //italic text// {{{monospace text}}} Les accolades triples sont pour noiki qui est facultativement monospace.
Gemtext N / A N / A ```alt text
monospace text
```
Le texte qui suit immédiatement les trois premiers backticks est un texte alternatif.
Notation de formatage Jira *bold text* _italic text_ {{monospace text}}
Réduction **bold text** *italic text* `monospace text` balises HTML sémantiques
__bold text__ _italic text_
TexteMarqué **bold text** //italic text// ;;monospace text;; balises HTML sémantiques
MediaWiki '''bold text''' ''italic text'' <code>monospace text</code> recourt principalement au HTML en ligne
Mode d'organisation *bold text* /italic text/ =code=
~verbatim~
PmWiki '''bold text''' ''italic text'' @@monospace text@@
du repos **bold text** *italic text* ``monospace text``
Sétexte **bold text** ~italic text~ N / A
Textile *strong* _emphasis_ @monospace text@ balises HTML sémantiques
**bold text** __italic text__ balises HTML de présentation
Texy ! **bold text** *italic text* `monospace text` balises HTML sémantiques par défaut, prise en charge facultative des balises de présentation
//italic text//
TiddlyWiki ''bold text'' //italic text// `monospace text`
``monospace text``
txt2tags **bold text** //italic text// ``monospace text``
COSSE B<bold text> I<italic text> C<monospace text> Le texte en retrait est également affiché sous forme de code à espacement fixe.
Mou *bold text* _italic text_ `monospace text` ```block of monospaced text```
WhatsApp *bold text* _italic text_ ```monospace text```

Gemtext n'a pas de formatage en ligne, le texte à espacement fixe (texte préformaté connu de la communauté Gemini) doit avoir l'ouverture et la fermeture ```sur leurs propres lignes.

Syntaxe d'accentuation

En HTML, le texte est mis en évidence avec les types d'élément <em>et <strong>, tandis que <i>et <b>marquent traditionnellement le texte pour qu'il soit en italique ou en gras, respectivement.

Microsoft Word et Outlook, et par conséquent d'autres logiciels de traitement de texte et clients de messagerie qui s'efforcent d'offrir une expérience utilisateur similaire, prennent en charge la convention de base consistant à utiliser des astérisques pour les caractères gras et des traits de soulignement pour le style italique. Alors que Word supprime les caractères, Outlook les conserve.

Caractère italique ou accent normal
Code AsciiDoc ATX le créole Jira Réduction TexteMarqué MediaWiki Mode d'organisation PmWiki du repos Sétexte Mou Textile Texy ! TiddlyWiki txt2tags WhatsApp
*italic* Non Non Non Non Oui Non Non Non Non Oui Non Non Non Oui Non Non Non
**italic** Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non
_italic_ Oui Oui Non Oui Oui Non Non Non Non Non Non Oui Oui Non Non Non Oui
__italic__ Oui Non Non Non Non Non Non Non Non Non Non Non Oui Non Non Non Non
'italic' Oui Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non
''italic'' Oui Non Non Non Non Non Oui Non Oui Non Non Non Non Non Non Non Non
/italic/ Non Non Non Non Non Non Non Oui Non Non Non Non Non Non Non Non Non
//italic// Non Non Oui Non Non Oui Non Non Non Non Non Non Non Oui Oui Oui Non
~italic~ Non Non Non Non Non Non Non Non Non Non Oui Non Non Non Non Non Non
Visage audacieux ou forte emphase
Code AsciiDoc ATX le créole Jira Réduction TexteMarqué MediaWiki Mode d'organisation PmWiki du repos Sétexte Mou Textile Texy ! TiddlyWiki txt2tags WhatsApp
*bold* Oui Oui Non Oui Non Non Non Oui Non Non Non Oui Oui Non Non Non Oui
**bold** Oui Non Oui Non Oui Oui Non Non Non Oui Oui Non Oui Oui Non Oui Non
__bold__ Non Non Non Non Oui Non Non Non Non Non Non Non Non Non Non Non Non
''bold'' Non Non Non Non Non Non Non Non Non Non Non Non Non Non Oui Non Non
'''bold''' Non Non Non Non Non Non Oui Non Oui Non Non Non Non Non Non Non Non

Syntaxe éditoriale

En HTML, le texte supprimé ou supprimé et inséré est balisé avec les types d'élément <del>et <ins>, respectivement. Cependant, les types d'éléments hérités <s>ou <strike>et <u>sont toujours également disponibles pour les portions de texte barrées et soulignées.

Texte souligné ou inséré
Code Jira Réduction TexteMarqué Mode d'organisation Sétexte TiddlyWiki txt2tags
_underline_ Non Optionnel Non Oui Oui Non Non
__underline__ Non Optionnel Non Non Non Oui Oui
+underline+ Oui Non Non Non Non Non Non
++underline++ Oui

AsciiDoc, ATX, Créole, MediaWiki, PmWiki, reST, Slack, Textile, Texy ! et WhatsApp ne prennent pas en charge le balisage dédié pour souligner le texte.

Texte barré ou supprimé
Code Jira Réduction TexteMarqué Mode d'organisation Mou TiddlyWiki txt2tags WhatsApp
~stricken~ Non Non Non Non Oui Non Non Oui
~~stricken~~ Non GFM Non Non Non Oui Non Non
+stricken+ Non Non Non Oui Non Non Non Non
-stricken- Oui Non Non Non Non Non Non Non
--stricken-- Non Non Oui Non Non Non Oui Non

AsciiDoc, ATX, Créole, MediaWiki, PmWiki, reST, Setext, Textile et Texy ! ne prennent pas en charge le balisage dédié pour la suppression du texte.

Syntaxe de programmation

Le code informatique cité est traditionnellement présenté dans des polices de type machine à écrire où chaque caractère occupe la même largeur fixe. HTML propose les types d'éléments de <code>présentation sémantiques et obsolètes <tt>pour cette tâche.

Police à espacement fixe, texte de télétype ou code
Code AsciiDoc ATX le créole Gemtext Jira Réduction TexteMarqué Mode d'organisation PmWiki du repos Mou Textile Texy ! TiddlyWiki txt2tags WhatsApp
@code@ Non Non Non Non Non Non Non Non Non Non Non Oui Non Non Non Non
@@code@@ Non Non Non Non Non Non Non Non Oui Non Non Non Non Non Non Non
`code` Oui Non Non Non Non Oui Non Non Non Non Oui Non Oui Oui Non Non
``code`` Oui Non Non Non Non Oui Non Non Non Oui Non Non Non Oui Oui Non
```code``` Non Non Non Oui Non Oui Non Non Non Non Oui Non Non Non Oui Non Oui
=code= Non Non Non Non Non Non Non Oui Non Non Non Non Non Non Non Non
~code~ Non Non Non Non Non Non Non Oui Non Non Non Non Non Non Non Non
+code+ Oui Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non
++code++ Oui Non Non Non Non Non Non Non Non Non Non Non Non Non Non Non
{{code}} Non Non Non Non Oui Non Non Non Non Non Non Non Non Non Non Non
{{{code}}} Non Non Oui Non Non Non Non Non Non Non Non Non Non Non Non Non
|code| Non Oui Non Non Non Non Non Non Non Non Non Non Non Non Non Non
;;code;; Oui

Mediawiki, Setext et Gemtext ne fournissent pas de balisage léger pour les étendues de code en ligne.

Syntaxe d'en-tête

Les en-têtes sont généralement disponibles jusqu'à six niveaux, mais celui du haut est souvent réservé pour contenir le même que le titre du document, qui peut être défini de manière externe. Certaines documentations peuvent associer des niveaux à des types de division, par exemple une partie, un chapitre, une section, un article ou un paragraphe.

La plupart des LML suivent l'un des deux styles d'en- tête , soit des soulignements de type Setext , soit des marqueurs de ligne de type atx , ou ils prennent en charge les deux.

Titres soulignés

Level 1 Heading
===============

Level 2 Heading
---------------

Level 3 Heading
~~~~~~~~~~~~~~~

Le premier style utilise des soulignements, c'est-à-dire des caractères répétés (par exemple égal à =, trait d'union -ou tilde ~, généralement au moins deux ou quatre fois) dans la ligne sous le texte du titre.

Niveaux de titre soulignés
Caractères : = - ~ * # + ^ _ : " ' ` . min
Réduction 1 2 Non Non Non Non Non Non Non Non Non Non Non 1
Sétexte 1 2 Non Non Non Non Non Non Non Non Non Non Non ?
AsciiDoc 1 2 3 Non Non Non Non Non Non Non Non Non Non 2
Texy ! 3 4 Non 2 1 Non Non Non Non Non Non Non Non 3
Texterestructuré Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui Oui largeur du titre

RST détermine les niveaux de titre de manière dynamique, ce qui rend la création plus individuelle d'une part, mais complique les fusions à partir de sources externes d'autre part.

En-têtes préfixés

# Level 1 Heading
## Level 2 Heading ##
### Level 3 Heading ###

Le second style est basé sur des marqueurs répétés (par exemple, dièse #, égal =ou astérisque *) au début du titre lui-même, où le nombre de répétitions indique le niveau (parfois inverse) du titre. La plupart des langues prennent également en charge la duplication des marqueurs en fin de ligne, mais alors que certains les rendent obligatoires, d'autres ne s'attendent même pas à ce que leurs numéros correspondent.

En-têtes de préfixe (et suffixe) de ligne
Personnage: = # * ! + Suffixe Niveaux Échancrure
AsciiDoc Oui Non Non Non Non Optionnel 1–6 Non
ATX Non Oui Non Non Non Non illimité ?
le créole Oui Non Non Non Non Optionnel 1–6 Non
Gemtext Non Oui Non Non Non ? 1-3 Non
MediaWiki Oui Non Non Non Non Oui 1–6 Non
TiddlyWiki Non Non Non Oui Non Non 1–6 Non
txt2tags Oui Non Non Non Oui Oui 1–6 Non
Réduction Non Oui Non Non Non Optionnel 1–6 Non
TexteMarqué Oui Non Non Non Non Non 1– +∞ Non
Texy ! Oui Oui Non Non Non Optionnel 6–1 ou 1–6, dynamique Non
Mode d'organisation Non Non Oui Non Non Non 1– +∞ alternative
PmWiki Non Non Non Oui Non Optionnel 1–6 Non

Le mode org prend en charge l'indentation comme moyen d'indiquer le niveau.

Le BBCode ne prend pas du tout en charge les en-têtes de section.

POD et Textile choisissent plutôt la convention HTML des niveaux d'en-tête numérotés.

Autres formats d'en-tête
Langue Format
COSSE
=head1 Level 1 Heading
=head2 Level 2 Heading
Textile , Jira
h1. Level 1 Heading
h2. Level 2 Heading
h3. Level 3 Heading
h4. Level 4 Heading
h5. Level 5 Heading
h6. Level 6 Heading

Microsoft Word prend en charge la mise en forme automatique des paragraphes en tant que titres s'ils ne contiennent pas plus d'une poignée de mots, pas de point à la fin et que l'utilisateur appuie deux fois sur la touche Entrée. Pour les niveaux inférieurs, l'utilisateur peut appuyer sur la touche de tabulation le nombre de fois correspondant avant de saisir le texte, c'est-à-dire un à huit onglets pour les niveaux de titre deux à neuf.

Syntaxe des liens

Les hyperliens peuvent être ajoutés en ligne, ce qui peut encombrer le code en raison de longues URL, ou avec aliasdes idréférences nommées ou numérotées à des lignes ne contenant rien d'autre que l'adresse et les attributs associés et peuvent souvent être situés n'importe où dans le document. La plupart des langues permettent à l'auteur de spécifier le texte Textà afficher au lieu de l'adresse simple http://example.comet certaines fournissent également des méthodes pour définir un titre de lien différent Titlequi peut contenir plus d'informations sur la destination.

Les LML adaptées à des configurations spéciales, par exemple les wikis ou la documentation de code, peuvent générer automatiquement des ancres nommées (pour les en-têtes, les fonctions, etc.) à l'intérieur du document, des liens vers des pages connexes (éventuellement dans un espace de noms différent) ou fournir une recherche textuelle pour les mots-clés liés .

La plupart des langues utilisent des crochets (doubles) carrés ou angulaires pour entourer les liens, mais pratiquement aucune langue n'est complètement compatible. Beaucoup peuvent reconnaître et analyser automatiquement les URL absolues à l'intérieur du texte sans autre balisage.

Syntaxe du lien hypertexte
Langues Syntaxe de base Syntaxe du texte Syntaxe du titre
BBCode, Créole, MediaWiki, PmWiki http://example.com
Textile "Text":http://example.com "Text (Title)":http://example.com
Texy ! "Text .(Title)":http://example.com
AsciiDoc http://example.com[Text]
Mou <http://example.com|Text>
TiddlyWiki [[Text|http://example.com]]
Jira [http://example.com] [Text|http://example.com]
txt2tags [Text http://example.com]
MediaWiki [http://example.com Text]
Créole, MediaWiki, PmWiki [[Name]] [[Name|Text]]
Mode d'organisation [[Name][Text]]
TiddlyWiki [[Text|Name]]
le créole [[Namespace:Name]] [[Namespace:Name|Text]]
Mode d'organisation [[Namespace:Name][Text]]
Créole, PmWiki [[http://example.com]] [[http://example.com|Text]]
BBCode [url]http://example.com[/url] [url=http://example.com]Text[/url]
Réduction <http://example.com> [Text](http://example.com) [Text](http://example.com "Title")
Texterestructuré `Text <http://example.com/>`_
TexteMarqué \\http://example.com/\\ \\Text\http://example.com\\
COSSE L</Name>
COSSE L<http://example.com/>
Gemtext => gemini://example.com => gemini://example.com Text

Les liens Gemtext doivent être sur une ligne par eux-mêmes, ils ne peuvent pas être utilisés en ligne.

Syntaxe de référence
Langues Syntaxe du texte Syntaxe du titre
Texterestructuré
… Name_ …
.. _Name: http://example.com
ATX
… [Text] …
[Text] http://example.com
AsciiDoc
… [[id]] …
<<id>>
… [[id]] …
<<id,Text>>
… anchor:id …
xref:id
… anchor:id …
xref:id[Text]
Réduction
… [Text][id] …
[id]: http://example.com
… [Text][id] …
[id]: http://example.com "Title"
… [Text][] …
[Text]: http://example.com
… [Text][] …
[Text]: http://example.com "Title"
… [Text] …
[Text]: http://example.com
… [Text] …
[Text]: http://example.com "Title"
Textile
… "Text":alias …
[alias]http://example.com
… "Text":alias …
[alias (Title)]http://example.com
Texy !
… "Text":alias …
[alias]: http://example.com
… "Text":alias …
[alias]: http://example.com .(Title)

La syntaxe de lien normale du mode org effectue une recherche de texte dans le fichier. Vous pouvez également mettre des cibles dédiées avec <<id>>.


Syntaxe de liste

HTML requiert un élément explicite pour la liste, spécifiant son type, et un pour chaque élément de la liste, mais la plupart des langages de balisage légers n'ont besoin que de différents préfixes de ligne pour les puces ou les éléments énumérés. Certains langages reposent sur l'indentation pour les listes imbriquées, d'autres utilisent des marqueurs de liste parent répétés.

Éléments de liste à puces non ordonnés
Personnages: * - + # . · _ : retrait sauter nid
Réduction Oui Oui Oui Non Non Non Non Non Non Non Non 0–3 1-3 retrait
TexteMarqué Non Oui Non Non Non Non Non Non Non Non Non 0 1 retrait
MediaWiki , TiddlyWiki Oui Non Non Non Non Non Non Non Non Non Non 0 1+ répéter
Mode d'organisation Oui Oui Oui Non Non Non Non Non Non Non Non 0+ retrait
Jira Oui Oui Non Non Non Non Non Non Non Non Non 0 1+ répéter
Gemtext Oui Non Non Non Non Non Non Non Non Non Non 0 1+ Non

Microsoft Word convertit automatiquement les paragraphes commençant par un astérisque *, un tiret moins -ou un crochet supérieur à >suivi d'un espace ou d'une tabulation horizontale en éléments de liste à puces. Il commencera également une liste énumérée pour le chiffre 1 et les lettres insensibles à la casse a (pour les listes alphabétiques) ou i (pour les chiffres romains), si elles sont suivies d'un point ., d'une parenthèse arrondie fermante ), d'un signe supérieur à >ou un tiret moins -et un espace ou une tabulation ; dans le cas d'une parenthèse ronde, une ouverture facultative (avant le marqueur de liste est également prise en charge.

Les langues diffèrent selon qu'elles prennent en charge les chiffres facultatifs ou obligatoires dans les éléments de liste numérotée, les types d'énumérateurs qu'elles comprennent (par exemple, chiffre décimal 1 , chiffres romains i ou I , lettres alphabétiques a ou A ) et si elles prennent en charge la conservation des valeurs explicites dans la sortie format. Certains dialectes Markdown, par exemple, respecteront une valeur de départ autre que 1, mais ignoreront toute autre valeur explicite.

Éléments de liste ordonnés et énumérés
Caractères : + # #1 1. 1) 1] 1} (1) [1] {1} a. A. i. I. retrait sauter nid
Réduction Non Non Non Oui Oui Non Non Non Non Non Non Non Non Non 0–3 1-3 retrait
TexteMarqué Oui Non Non Non Non Non Non Non Non Non Non Non Non Non 0 1 retrait
MediaWiki , TiddlyWiki Non Oui Non Non Non Non Non Non Non Non Non Non Non Non 0 1+ répéter
Mode d'organisation Non Non Non Oui Oui Non Non Non Non Non Optionnel Non Non 0+ retrait
Jira Non Oui Non Non Non Non Non Non Non Non Non Non Non Non 0 1+ répéter

Slack aide l'utilisateur à saisir des listes énumérées et à puces, mais ne les formate pas réellement en tant que telles, c'est-à-dire qu'il inclut simplement un chiffre de début suivi d'un point et d'un espace ou d'une puce devant une ligne.

Étiqueté, glossaire, syntaxe de liste de définitions
Langues Terme en cours de définition Définition du terme
MediaWiki ; Term : Definition
TiddlyWiki
Mode d'organisation - Term :: Definition


Voir également

Les références

Liens externes