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
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 |
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
Langue | Implémentations | X HTML | Con / La TeX | DocBook | FDAL | EPUB | DOC (X) | LML | Autre | Licence | |
---|---|---|---|---|---|---|---|---|---|---|---|
AsciiDoc | Python , Ruby , JavaScript , Java | XHTML | Latex | 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 | 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 | 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 | Non | FDAL | Non | DOC, RTF | - | OPML | GPL , MIT | |
Mode d'organisation | Emacs Lisp , Ruby (analyseur uniquement), Perl , OCaml | XHTML | Latex | 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 | DocBook | Non | Non | RTF | - | Page de manuel , texte brut | Licence Artistique , Licence Perl | |
Texterestructuré | Python , Haskell (Pandoc) , Java , | HTML, XML | Latex | 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 | 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 em
et au strong
lieu. Le texte à espacement fixe peut entraîner des éléments sémantiques code
ou 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.
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**t rendements 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
|
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```
|
*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.
Code | AsciiDoc | ATX | le créole | Jira | Réduction | TexteMarqué | MediaWiki | Mode d'organisation | PmWiki | du repos | Sétexte | Mou | Textile | Texy ! | TiddlyWiki | txt2tags | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
*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 |
Code | AsciiDoc | ATX | le créole | Jira | Réduction | TexteMarqué | MediaWiki | Mode d'organisation | PmWiki | du repos | Sétexte | Mou | Textile | Texy ! | TiddlyWiki | txt2tags | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
*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.
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.
Code | Jira | Réduction | TexteMarqué | Mode d'organisation | Mou | TiddlyWiki | txt2tags | |
---|---|---|---|---|---|---|---|---|
~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.
Code | AsciiDoc | ATX | le créole | Gemtext | Jira | Réduction | TexteMarqué | Mode d'organisation | PmWiki | du repos | Mou | Textile | Texy ! | TiddlyWiki | txt2tags | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
@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.
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.
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.
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 alias
des id
ré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.com
et certaines fournissent également des méthodes pour définir un titre de lien différent Title
qui 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.
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.
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.
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.
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.
Langues | Terme en cours de définition | Définition du terme |
---|---|---|
MediaWiki |
; Term
|
: Definition
|
TiddlyWiki | ||
Mode d'organisation |
- Term :: Definition
|
Voir également
- Langage de programmation léger
- Comparaison des langages de balisage de document
- Comparaison des générateurs de documentation
- Wikitexte
- Réduction