Maxisnt: 1 revision imported

2026-08-12T13:57:12Z

1 revision imported

← Older revision		Revision as of 13:57, 12 August 2026
(No difference)

Wikipedia>Scyrme: mentioning MOS:CHEMINDENT as this guideline is followed by chemistry articles but differs from the general guidance at MOS:INDENT

2026-07-17T23:15:50Z

mentioning MOS:CHEMINDENT as this guideline is followed by chemistry articles but differs from the general guidance at MOS:INDENT

New page

{{Documentation subpage}}
{{High-use}}
{{Lua|Module:Chem2}}
{{COinS safe|n}}
'''{{tl|chem2}}''' is a template used to format a [[chemical formula]] or [[chemical equation|equation]].

When displaying a chemical equation on its own line, it should be indented using a colon ({{colon}}) and not centered. (For further information, see [[MOS:CHEMINDENT]].)

== Use ==
=== Formula punctuation ===
{| class="wikitable"
|-
! Symbol
! Gives
! Example
! Output
|-
| <code>\s</code> || {{chem2|\s}} || <code><nowiki>{{chem2|CH3\sCH3}}</nowiki></code> || {{chem2|CH3\sCH3}}
|-
| <code>\d</code> || {{chem2|\d}} || <code><nowiki>{{chem2|CH2\dCH2}}</nowiki></code> || {{chem2|CH2\dCH2}}
|-
| <code>\t</code> || {{chem2|\t}} || <code><nowiki>{{chem2|HC\tCH}}</nowiki></code> || {{chem2|HC\tCH}}
|-
| <code>\q</code> || {{chem2|\q}} || <code><nowiki>{{chem2|[Cl4Re\qReCl4](2−)}}</nowiki></code> || {{chem2|[Cl4Re\qReCl4](2−)}}
|-
| <code>\-</code> || {{chem2|\-}} || <syntaxhighlight lang="tex" inline>{{chem2|A\-B}}</syntaxhighlight> || {{chem2|A\-B}}
|-
| <code>\\</code> || {{chem2|\\}} || <syntaxhighlight lang="tex" inline>{{chem2|C\\D}}</syntaxhighlight> || {{chem2|C\\D}}
|-
| <code>\h</code> || {{chem2|\h}} || <syntaxhighlight lang="tex" inline>{{chem2|\h}}</syntaxhighlight> || {{chem2|\h}}
|-
| <code>\h{1}</code> || {{chem2|\h{1}|}} || <syntaxhighlight lang="tex" inline>{{chem2|\h{1} |}}</syntaxhighlight> {{right|1=[[#end-bracket issue|§ <nowiki>{}</nowiki>]]}} || {{chem2|\h{1}|}}
|-
| <code>\m{1}</code> || {{chem2|\m{1}|}} || <syntaxhighlight lang="tex" inline>{{chem2|\m{1} |}}</syntaxhighlight> || {{chem2|\m{1}|}}
|-
| <code>-></code> || {{chem2|->}} || <code><nowiki>{{chem2|2H2 + O2 -> 2H2O}}</nowiki></code> {{right|1=[[#end-bracket issue|§ <nowiki>{}</nowiki>]]}} || {{chem2|2H2 + O2 -> 2H2O}}
|-
| <code><-></code> || {{chem2|<->}} || <code><nowiki>{{chem2|K<->L}}</nowiki></code> || {{chem2|K<->L}}
|-
| <code>*</code> || <big>{{chem2|*}}</big> || <code><nowiki>{{chem2|CoCl2*6H2O}}</nowiki></code> || {{chem2|CoCl2*6H2O}}
|-
| <code>\*</code> || * || <syntaxhighlight lang="tex" inline>{{chem2|Cp\*2Fe}}</syntaxhighlight> || {{chem2|Cp\*2Fe}}
|-
| <code>_{}</code> || subscript|| <syntaxhighlight lang="wikitext" inline>{{chem2|C_{''n''}H_{2''n''+2} }}</syntaxhighlight> {{right|1=[[#end-bracket issue|§ <nowiki>{}</nowiki>]]}} || {{chem2|C_{''n''}H_{2''n''+2} }}
|-
| <code>^{}</code> || superscript|| <code><nowiki>{{chem2|^{13}CH4}}</nowiki></code> || {{chem2|^{13}CH4}}
|-
| <code>&nabla;</code> || {{chem2|∇}} || <syntaxhighlight lang="wikitext" inline>{{chem2|∇}}</syntaxhighlight> || {{chem2|∇}}
|-
| <code>( )</code> || {{chem2|( )}} || <code><nowiki>{{chem2|R\sCH(OH)CN}}</nowiki></code> || {{chem2|R\sCH(OH)CN}}
|}

=== End <nowiki>}</nowiki>-bracket issue ===
When input ends correctly with a <big><nowiki>}</nowiki></big>-bracket, like with <code><nowiki>A_{x}H_{1-x</nowiki>{{hl|1=<nowiki>}</nowiki>}}</code>, the final <nowiki>}</nowiki>-brackets are technically mixed up:
: <code><nowiki>{{</nowiki>chem2|A_{x}H_{1-x{{hl|1=<nowiki>}}}</nowiki>}}</code> → {{chem2|A_{x}H_{1-x}}} {{nay}}

The closing bracket {{code|<nowiki>}</nowiki>}} of input ''and'' end of template brackets {{code|<nowiki>}}</nowiki>}} are interpreted by Wikipedia software in reversed order.

* Solutions:
::: Empty pipe: <code><nowiki>{{chem2|...{...</nowiki>{{hl|1=<nowiki>}|}}</nowiki>}}</code> (empty parameter #2)
::: Parameters numbers 1 and 2 (empty): <code><nowiki>{{chem2|1=...{...</nowiki>{{hl|1=<nowiki>}|2=}}</nowiki>}}</code>
::: Space: <code><nowiki>{{chem2|...{...</nowiki>{{hl|1=<nowiki>} }}</nowiki>}}</code>
::: Nowiki tag: <code><nowiki>{{chem2|...{...</nowiki>{{hl|1=<nowiki>}<nowiki/>}}</nowiki>}}</code>
::: [[template:(|Escape]] the last set of brackets: <code><nowiki>{{</nowiki>chem2|A_{x}H_{{hl|1={{tl|(}}}}1-x{{hl|1={{tl|)}}}}}}</code>
:Result: <code><nowiki>{{</nowiki>chem2|A_{x}H_{1-x{{hl|1=<nowiki>}|}}</nowiki>}}</code> → {{chem2|A_{x}H_{1-x}|}} {{aye}}

== Formulas, charges, and equations ==
Formulas (without charge) are just written:
* {{#invoke: DemoTemplate|chem2|CH3(CH2)5CH3}}
* {{#invoke: DemoTemplate|chem2|Fe3S2(CO)9}}
* {{#invoke: DemoTemplate|chem2|C_{''n''}H_{2''n''+2}|}}

Charges are written inside parentheses:
* {{#invoke: DemoTemplate|chem2|SO4(2-)}}
* {{#invoke: DemoTemplate|chem2|S19(2+)}}

Charges +1 and −1 can be written plain:
* {{#invoke: DemoTemplate|chem2|Na+}}
* {{#invoke: DemoTemplate|chem2|O2-}}
: same as {{#invoke: DemoTemplate|chem2|O2(-)}}

Chemical equations:
* {{#invoke: DemoTemplate|chem2|2 S + 3 O2 + 2 H2O -> 2 H2SO4}}
* {{#invoke: DemoTemplate|chem2|2S + 3O2 + 2H2O -> 2H2SO4}}
The arrows can be written as <code>-></code> or just <code>→</code>. All characters (and unicode markup) are valid input except <code>\</code>, = (Mediawiki use it), <code>_</code> and <code>-</code> (endash etc.)
* {{#invoke: DemoTemplate|chem2|2 H2(g) + O2(g) -> 2H2O(g)|}}
* {{#invoke: DemoTemplate|chem2|NH2RCHCO2H <-> NH3+RCHCO2-}}

[[Hapticity]] and [[bridging ligand]]s:
* {{#invoke: DemoTemplate|chem2|(\h{5}Cp)FeCO(\m{2}CO)FeCO(\h{5}Cp)}}
* {{#invoke: DemoTemplate|chem2|(\h{5}Cp)FeCO(\m{2}CO)FeCO(\h{5}Cp)|auto=yes}}

== Wikilinks ==
{{As of|March 2023}}, {{template|chem2}} should ''not'' be used inside wikilinks; this can cause erratic failures to properly render sub/superscripts in other invocations on the same page. Instead, use the following options.

=== Whole formula link ===
Link the whole formula with {{para|link|<wiki pagename>}}:
* {{#invoke:DemoTemplate|chem2|FeCl3|link=Iron(III) chloride}}

Or use wikilink brackets in input like {{elc|ammonia|NH3}}:
* {{Demo-inline|<nowiki>{{chem2|3[[hydrogen|H2]] + 2[[nitrogen|N2]] <-> 2[[ammonia|NH3]]}}</nowiki>}}

=== Link each element (C, Hg) and generic element code (R, X) ===
Use {{para|auto|yes}} to link from the first occurrence of each element symbol, and some functional-group symbols such as {{chem2|auto=1|Ph}}
* {{#invoke:DemoTemplate|chem2|auto=yes|CH3CH2CH3CBrFCIClCH3}}

=== Link functional groups ===
Some common '''groups''' are recognized and linked if you wikilink them using {{elc| }}
* {{Demo-inline|<nowiki>{{chem2|R\-[[COOH]]}}</nowiki>}}
* {{Demo-inline|<nowiki>{{chem2|[[CH3]]C[[R]]2[[I]]}}</nowiki>}}
* In particular H2O links to [[water of crystallization]] in {{Demo-inline|<nowiki>{{chem2|CuSO4 * 5 [[H2O]]}}</nowiki>}}, because a link to water is generally unnecessary.

You can link to any article even if chem2 is unaware of it:
* {{#invoke:DemoTemplate|chem2|[[C6H5NH2]]}}

To change the default link:
* {{#invoke: DemoTemplate|chem2|[[water|H2O]]}}

=== All recognised symbols and codes ===
{{Collapse top |bg=#CEF2E0 |title=All link targets recognised by {{tlf|chem2}} (elements, general codes, functional groups)}}
{{Div col}}
{{#invoke:chem2|_autodoc}}
{{Div col end}}
{{Collapse bottom}}

== Examples and tests ==
(The first "→" in each example is not part of the output; it separates the example from its output.)
* {{#invoke: DemoTemplate|chem2|[Cl4Re\qReCl4](2-)|}}
* {{#invoke: DemoTemplate|chem2|NH2RCHCO2H <-> NH3+RCHCO2−}}
----
* {{#invoke: DemoTemplate|chem2|\\hallo}}
* {{#invoke: DemoTemplate|chem2|H3CC\tCH <-> H2C\dC\dCH2}}
* {{#invoke: DemoTemplate|chem2|4 NH3 + 5 O2 -> 4 NO + 6 H2O}}
----
* {{#invoke: DemoTemplate|chem2|H2O → H2O}}
* {{#invoke: DemoTemplate|chem2|H2O(l) -> H2O(g)}}
----
* {{#invoke: DemoTemplate|chem2|4 NH3 + 5 O2 → 4 NO + 6 H2O}}
* {{#invoke: DemoTemplate|chem2|4NH3 + 5O2 → 4NO + 6H2O}}
* {{#invoke: DemoTemplate|chem2|2Mn2(+)}}
* {{#invoke: DemoTemplate|chem2|2Mn2(+) + 3H2O}}
* {{#invoke: DemoTemplate|chem2|Mn–}}
----
* {{#invoke: DemoTemplate|chem2|Mn2(2-)}}
* {{#invoke: DemoTemplate|chem2|Mn2☃+}};
* {{#invoke: DemoTemplate|chem2|Mn2(2☃–)}}
* {{#invoke: DemoTemplate|chem2|Mn2(+)}}
* {{#invoke: DemoTemplate|chem2|Mn2+}}
* {{#invoke: DemoTemplate|chem2|Mn2(-)}}
* {{#invoke: DemoTemplate|chem2|Mn2-}}
----
* {{Demo-inline|<nowiki>{{chem2|C_{''n''}H_{2''n'' + 2}|}}</nowiki>}}
* (chem: {{Demo-inline|<nowiki>{{chem|C|''n''|H|2''n'' + 2}}</nowiki>}}
* {{#invoke: DemoTemplate|chem2|C_{abc}|}}
* {{#invoke: DemoTemplate|chem2|CoCl2*1.5H2O}}
* {{#invoke: DemoTemplate|chem2|Cu2C2*H2O}}
----
'''Special'''

* {{#invoke: DemoTemplate|chem2|[Me2Al(\m{2}Me)]2}}
* {{#invoke: DemoTemplate|chem2|^{13}CO2}}
* {{#invoke: DemoTemplate|chem2|auto=yes|^{13}CO2}}
* {{#invoke: DemoTemplate|chem2|\h{5}(C5H5)2TiCl2}}
* (bad) {{#invoke: DemoTemplate|chem2|\h{5}\s(C5H5)2TiCl2}}
* {{#invoke: DemoTemplate|chem2|CH2\dCH2\sCH2\sC\tCH\qMn}}
----
* {{#invoke: DemoTemplate|chem2|RC(OR')3}}
* {{#invoke: DemoTemplate|chem2|C\\C}}
* {{#invoke: DemoTemplate|chem2|C2*NH3}}
* {{#invoke: DemoTemplate|chem2|C2*2NH3}}
* {{#invoke: DemoTemplate|chem2|C1.2H3.5}}
----
* {{#invoke: DemoTemplate|chem2|\b\bAbC\e\e}}
* {{#invoke: DemoTemplate|chem2|C2(μ\-C)}}
----
* {{#invoke: DemoTemplate|chem2|SO4(2-)}}
* {{#invoke: DemoTemplate|chem2|2Mn2(2+)}}
* {{#invoke: DemoTemplate|chem2|CH3-CH2-OH}}
* {{#invoke: DemoTemplate|chem2|[ZnCl4]-}}
* {{#invoke: DemoTemplate|chem2|[ZnCl4](2-)}}
* {{#invoke: DemoTemplate|chem2|auto=yes|((H2O)5{CoCl2})2}}
* {{#invoke: DemoTemplate|chem2|Si(OH)4}}
----
* {{#invoke: DemoTemplate|chem2|auto=yes|Cu2C2*H2O}}
* {{#invoke: DemoTemplate|chem2|Cu2C2*2H2O}}
* {{#invoke: DemoTemplate|chem2|CuSO*2H2O}}
* {{#invoke: DemoTemplate|chem2|CuSO4*15H2O}}
* {{#invoke: DemoTemplate|chem2|CuSO4(H2O)5}}
* {{#invoke: DemoTemplate|chem2|H+ + OH- → H2O}}
* {{#invoke: DemoTemplate|chem2|H → O}}
----
* {{#invoke: DemoTemplate|chem2|ZxPo4}}     Unknown element.
* {{#invoke: DemoTemplate|chem2|((Na)Cl}}     Too many "(".
* {{#invoke: DemoTemplate|chem2|Si(OH))4}}     Too many ")".
* {{#invoke: DemoTemplate|chem2|Si&[[☃]]Si}}
* {{#invoke: DemoTemplate|chem2|1=CH2=CH2}}

=== More ===
* {{#invoke: DemoTemplate|chem2|Cl2O6|link=dichlorine hexoxide}}
* {{#invoke: DemoTemplate|chem2|[Fe(Phen)(Phen)3](2+)}}
* {{#invoke: DemoTemplate|chem2|auto=yes|[Fe(Phen)(Phen)3](2+)}}
* {{#invoke: DemoTemplate|chem2|[C2O2](2+)}}
* {{#invoke: DemoTemplate|chem2|SI4|link=Tomato}}
* {{#invoke: DemoTemplate|chem2|H2SO4+}}
* {{#invoke: DemoTemplate|chem2|Mn-}}
* {{#invoke: DemoTemplate|chem2|Mn22+}}, {{#invoke:DemoTemplate|chem2|Mn22-}}
* {{#invoke: DemoTemplate|chem2|Mn(2+)}}
* {{#invoke: DemoTemplate|chem2|Mn2(+)}}
* {{#invoke: DemoTemplate|chem2|Mn(22-)}}
* {{#invoke: DemoTemplate|chem2|Mn3(22-)}}
* {{#invoke: DemoTemplate|chem2|Mn(22+)}}
* {{#invoke: DemoTemplate|chem2|Mn2(22+)}}
* {{#invoke: DemoTemplate|chem2|Mn2(2+)}}
* {{#invoke: DemoTemplate|chem2|Mn22(2+)}}

=== Chem vs. chem2 ===
* {{#invoke: DemoTemplate|chem|(CH|3|)|2|CO}}
* {{#invoke: DemoTemplate|chem2|(CH3)2CO}}
* {{#invoke: DemoTemplate|chem|H|2|+}}
* {{#invoke: DemoTemplate|chem2|H2+}}

== Predefined codes (groups etc.) {{anchor|Predefined}} ==
{| class="wikitable sortable collapsible" style="font-size"90%"
|-
! colspan="5" | Predefined codes
|-
! code
! target article
! <code><nowiki>{{chem2|code}}</nowiki></code>
! type
! note
|-
! colspan="5" style="text-align:left;" | A. Groups etc with element-like names

{{chem2/doc/row |code=Bz |wl=Benzoyl group |addwl=no |type=A |note=}}
{{chem2/doc/row |code=Et |wl=Ethyl group |addwl=no |type=A |note=}}
{{chem2/doc/row |code=Ln |wl=Lanthanide |addwl=no |type=A |note=}}
{{chem2/doc/row |code=Nu |wl=Nucleophile |addwl=no |type=A |note=}}
{{chem2/doc/row |code=Ph |wl=Phenyl group |addwl=no |type=A |note=}}
{{chem2/doc/row |code=R |wl=Substituent |addwl=no |type=A |note=}}
{{chem2/doc/row |code=T |wl=Tritium |addwl=no |type=A |note=}}
{{chem2/doc/row |code=Tf |wl=Trifluoromethylsulfonyl group |addwl=no |type=A |note=}}
{{chem2/doc/row |code=X |wl=Halogen |addwl=no |type=A |note=}}
|-
! colspan="5" style="text-align:left;" | B. Groups which are redirected from their normal target if wikilinked; never autolinked.
{{chem2/doc/row |code=CH3 |wl=Methyl group |addwl=yes |type=B |note=}}
{{chem2/doc/row |code=CO3 |wl=Carbonate |addwl=yes |type=B |note=}}
{{chem2/doc/row |code=COOH |wl=Carboxyl group |addwl=yes |type=B |note=}}
{{chem2/doc/row |code=ClO |wl=Hypochlorite |addwl=yes |type=B |note=}}
{{chem2/doc/row |code=ClO2 |wl=Chlorite |addwl=yes |type=B |note=}}
{{chem2/doc/row |code=ClO3 |wl=Chlorate |addwl=yes |type=B |note=}}
{{chem2/doc/row |code=ClO4 |wl=Perchlorate |addwl=yes |type=B |note=}}
{{chem2/doc/row |code=H2O |wl=Water of crystallization |addwl=yes |type=B |note=}}
{{chem2/doc/row |code=H3O |wl=Hydronium |addwl=yes |type=B |note=}}
{{chem2/doc/row |code=NH2 |wl=Amine group |addwl=yes |type=B |note=}}
{{chem2/doc/row |code=NH4 |wl=Ammonium |addwl=yes |type=B |note=}}
{{chem2/doc/row |code=NO3 |wl=Nitrate |addwl=yes |type=B |note=}}
{{chem2/doc/row |code=PO3 |wl=Phosphite |addwl=yes |type=B |note=}}
{{chem2/doc/row |code=PO4 |wl=Phosphate |addwl=yes |type=B |note=}}
{{chem2/doc/row |code=SH |wl=Thiol group |addwl=yes |type=B |note=}}
{{chem2/doc/row |code=SO3 |wl=Sulfite |addwl=yes |type=B |note=}}
{{chem2/doc/row |code=SO4 |wl=Sulfate |addwl=yes |type=B |note=}}
{{chem2/doc/row |code=SeH |wl=Selenol group |addwl=yes |type=B |note=}}
|}

== TemplateData ==
{{TemplateData header}}

<templatedata>
{
"params": {
"1": {
"label": "Formula",
"description": "The chemical formula or equation in mhchem, which can also be hyperlinked manually. See template documentation for how this works.",
"example": "5HS- + 8NO3- + 3H+ -> 5SO4(2-) + 4N2 + 4H2O + 40e-",
"type": "string",
"suggested": true
},
"auto": {
"label": "Autolinked?",
"description": "Hyperlink every first instance of chemical elements, functional groups, and other generic element codes. ",
"type": "boolean",
"default": "no"
},
"link": {
"label": "Whole formula link",
"description": "Hyperlink the entire formula or equation to a given article page.",
"type": "wiki-page-name"
}
},
"description": "Formats a chemical formula or equation using mhchem code. See template documentation for details on how it works."
}
</templatedata>

== Tracking ==
* {{Category link with count |Pages using Chem2 with parameter issues |pages}}

== See also ==
* {{tl|Chem}}
* <<nowiki />chem>: [[WP:MATHCHEM]] — by TeX

<includeonly>{{Sandbox other||
[[Category:Modules in beta]]
[[Category:Chemistry formatting and function templates]]
}}</includeonly>

Template:Chem2/doc - Revision history

Maxisnt: 1 revision imported

Wikipedia>Scyrme: mentioning MOS:CHEMINDENT as this guideline is followed by chemistry articles but differs from the general guidance at MOS:INDENT