It has been suggested that some portions of this article besplit into multiple articles. (Discuss)(March 2025)

Alightweight markup language (LML), also termed asimple orhumane markup language, is amarkup language with simple, unobtrusive syntax. It is designed to be easy to write using any generic text editor and easy to read in its raw form. Lightweight markup languages are used in applications where it may be necessary to read the raw document as well as the final rendered output.

For instance, a person downloading a software library might prefer to read the documentation in a text editor rather than a web browser. Another application for such languages is to provide for data entry in web-based publishing, such asblogs andwikis, where the input interface is a simpletext box. The server software then converts the input into a commondocument markup language likeHTML.

Lightweight markup languages were originally used on text-only displays which could not display characters initalics orbold, so informal methods to convey this information had to be developed. This formatting choice was naturally carried forth to plain-text email communications.Console browsers may also resort to similar display conventions.

In 1986 international standardSGML provided facilities to define and parse lightweight markup languages using grammars and tag implication. The 1998 W3CXML is a profile of SGML that omits these facilities. However, no SGMLdocument type definition (DTD) for any of the languages listed below is known.

Lightweight markup languages can be categorized by their tag types. Like HTML (<b>bold</b>), some languages use named elements that share a common format for start and end tags (e.g.BBCode[b]bold[/b]), whereas proper lightweight markup languages are restricted toASCII-only punctuation marks and other non-letter symbols for tags, but some also mix both styles (e.g.Textilebq.) or allow embedded HTML (e.g.Markdown), possibly extended with custom elements (e.g.MediaWiki<ref>'''source'''</ref>).

Most languages distinguish between markup for lines or blocks and for shorter spans of texts, but some only support inline markup.

Some markup languages are tailored for a specific purpose, such as documenting computer code (e.g.POD,reST,RD) or being converted to a certain output format (usually HTML orLaTeX) and nothing else, others are more general in application. This includes whether they are oriented on textual presentation or on data serialization.^{[clarification needed]}

Presentation oriented languages includeAsciiDoc,atx,BBCode,Creole, Crossmark, Djot, Epytext,Haml,JsonML,MakeDoc,Markdown,Org-mode,POD (Perl),reST (Python), RD (Ruby),Setext,SiSU,SPIP, Xupl,Texy!, Textile,txt2tags,UDO andWikitext.

Data serialization oriented languages includeCurl (homoiconic, but also reads JSON; every object serializes),JSON, andYAML.

This sectionneeds expansion with: comparison table with types of languages explained above; could be integrated into other high-level tables. You can help byadding to it.(June 2014)

Markdown's own syntax does not support class attributes or id attributes; however, since Markdown supports the inclusion of native HTML code, these features can be implemented using direct HTML. (Some extensions may support these features.)

txt2tags' own syntax does not support class attributes or id attributes; however, since txt2tags supports inclusion of native HTML code in tagged areas, these features can be implemented using direct HTML when saving to an HTML target.^[26]

DokuWiki does not support HTML import natively, but HTML to DokuWiki converters and importers exist and are mentioned in the official documentation.^[27] DokuWiki does not support class or id attributes, but can be set up to support HTML code, which does support both features. HTML code support was built-in before release 2023-04-04.^[28] In later versions, HTML code support can be achieved through plugins, though it is discouraged.^[28]

Although usually documented as yielding italic and bold text, most lightweight markup processors output semantic HTML elementsem andstrong instead. Monospaced text may either result in semanticcode or presentationaltt elements. Few languages make a distinction, e.g. Textile, or allow the user to configure the output easily, e.g. Texy.

LMLs sometimes differ for multi-word markup where some require the markup characters to replace the inter-word spaces (infix).Some languages require a single character as prefix and suffix, other need doubled or even tripled ones or support both with slightly different meaning, e.g. different levels of emphasis.

Gemtext does not have any inline formatting, monospaced text (called preformatted text in the context of Gemtext) must have the opening and closing``` on their own lines.

In HTML, text is emphasized with the<em> and<strong> element types, whereas<i> and<b> traditionally mark up text to be italicized or bold-faced, respectively.

Microsoft Word and Outlook, and accordingly other word processors and mail clients that strive for a similar user experience, support the basic convention of using asterisks for boldface and underscores for italic style. While Word removes the characters, Outlook retains them.

In HTML, removed or deleted and inserted text is marked up with the<del> and<ins> element types, respectively. However, legacy element types<s> or<strike> and<u> are still also available for stricken and underlined spans of text.

AsciiDoc, ATX, Creole, MediaWiki, PmWiki, reST, Slack, Textile, Texy! and WhatsApp do not support dedicated markup for underlining text. Textile does, however, support insertion via the+inserted+ syntax.

ATX, Creole, MediaWiki, PmWiki, reST, Setext and Texy! do not support dedicated markup for striking through text.

DokuWiki supports HTML-like<del>stricken</del> syntax, even with embedded HTML disabled.

AsciiDoc supports stricken text through a built-intext span^[c] prefix:[.line-through]#stricken#.

Quoted computer code is traditionally presented in typewriter-like fonts where each character occupies the same fixed width. HTML offers the semantic<code> and the deprecated, presentational<tt> element types for this task.

Mediawiki and Gemtext do not provide lightweight markup for inline code spans.

Headings are usually available in up to six levels, but the top one is often reserved to contain the same as the document title, which may be set externally. Some documentation may associate levels with divisional types, e.g. part, chapter, section, article or paragraph. This article uses1 as the top level, but index of heading levels may begin at1 or0 in official documentation.

Most LMLs follow one of two styles for headings, eitherSetext-like underlines oratx-like^[50] line markers, or they support both.

Level 1 Heading===============Level 2 Heading---------------Level 3 Heading~~~~~~~~~~~~~~~

The first style uses underlines, i.e. repeated characters (e.g. equals=, hyphen- or tilde~, usually at least two or four times) in the line below the heading text.

Headings may optionally be overline inreStructuredText, in addition to being underlined.

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

The second style is based on repeated markers (e.g. hash#, equals= or asterisk*) at the start of the heading itself, where the number of repetitions indicates the (sometimes inverse) heading level. Most languages also support the reduplication of the markers at the end of the line, but whereas some make them mandatory, others do not even expect their numbers to match.

Org-mode supports indentation as a means of indicating the level.

BBCode does not support section headings at all.

POD and Textile choose the HTML convention of numbered heading levels instead.

=head1 Level 1 Heading=head2 Level 2 Heading

h1. Level 1 Headingh2. Level 2 Headingh3. Level 3 Headingh4. Level 4 Headingh5. Level 5 Headingh6. Level 6 Heading

Microsoft Word supports auto-formatting paragraphs as headings if they do not contain more than a handful of words, no period at the end and the user hits the enter key twice. For lower levels, the user may press the tabulator key the according number of times before entering the text, i.e. one through eight tabs for heading levels two through nine.

Hyperlinks can either be added inline, which may clutter the code because of long URLs, or with namedalias or numberedid references to lines containing nothing but the address and related attributes and often may be located anywhere in the document.Most languages allow the author to specify textText to be displayed instead of the plain addresshttp://example.com and some also provide methods to set a different link titleTitle which may contain more information about the destination.

LMLs that are tailored for special setups, e.g. wikis or code documentation, may automatically generate named anchors (for headings, functions etc.) inside the document, link to related pages (possibly in a different namespace) or provide a textual search for linked keywords.

Most languages employ (double) square or angular brackets to surround links, but hardly any two languages are completely compatible. Many can automatically recognize and parse absolute URLs inside the text without further markup.

Gemtext and setext links must be on a line by themselves, they cannot be used inline.

… [[id]] …<<id>>

… [[id]] …<<id,Text>>

… anchor:id …xref:id

… anchor:id …xref:id[Text]

… [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"

… Name_ ….._Name: http://example.com

… Link_name_ …^.. _Link_name URL

… "Text":alias …[alias]http://example.com

… "Text":alias …[alias (Title)]http://example.com

… "Text":alias …[alias]: http://example.com

… "Text":alias …[alias]: http://example.com .(Title)

Org-mode's normal link syntax does a text search of the file. You can also put in dedicated targets with<<id>>.

This sectionneeds expansion with: comparison table featuring how languages handle embedded images, audio, video and other types of media (e.g. social media links). You can help byadding to it.(June 2014)

HTML requires an explicit element for the list, specifying its type, and one for each list item, but most lightweight markup languages need only different line prefixes for the bullet points or enumerated items. Some languages rely on indentation for nested lists, others use repeated parent list markers.

Microsoft Word automatically converts paragraphs that start with an asterisk*, hyphen-minus- or greater-than bracket> followed by a space or horizontal tabulator as bullet list items. It will also start an enumerated list for the digit1 and the case-insensitive lettersa (for alphabetic lists) ori (for roman numerals), if they are followed by a period., a closing round parenthesis), a greater-than sign> or a hyphen-minus- and a space or tab; in case of the round parenthesis an optional opening one( before the list marker is also supported.

Languages differ on whether they support optional or mandatory digits in numbered list items, which kinds of enumerators they understand (e.g. decimal digit1, roman numeralsi orI, alphabetic lettersa orA) and whether they support to keep explicit values in the output format. Some Markdown dialects, for instance, will respect a start value other than 1, but ignore any other explicit value.

Slack assists the user in entering enumerated and bullet lists, but does not actually format them as such, i.e. it just includes a leading digit followed by a period and a space or a bullet character• in front of a line.

Term:    - Definition

This sectionneeds expansion with: differentiation between in-line and block quotes, as well as any handling for attribution. You can help byadding to it.(June 2014)

This sectionneeds expansion with: Cell, Row, Column, Header, Caption. You can help byadding to it.(June 2014)

The following lightweight markup languages, while similar to some of those already mentioned, have not yet been added to the comparison tables in this article:

• EtText:^[55] circa 2000.
• Grutatext:^[56] circa 2002.

• Comparison of document-markup languages
• Comparison of documentation generators
• Lightweight programming language

• Curl at Wikibooks

• Lightweight markup languages
• Computing-related lists
• Data serialization formats
• Markup language comparisons
• Markup languages

• Webarchive template wayback links
• Articles with short description
• Short description matches Wikidata
• Articles to be split from March 2025
• All articles to be split
• Wikipedia articles needing clarification from June 2014
• Articles to be expanded from June 2014
• All articles to be expanded