Template:Chem2
This template is used on approximately 7,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them. |
This template uses Lua: |
This template should not be used in citation templates such as Citation Style 1 and Citation Style 2, because it includes markup that will pollute the COinS metadata they produce; see Wikipedia:COinS. |
{{chem2}} is a template used to format a chemical formula or equation.
Use
Formula punctuation
Symbol | Gives | Example | Output |
---|---|---|---|
\s |
− | {{chem2|CH3\sCH3}} |
CH3−CH3 |
\d |
= | {{chem2|CH2\dCH2}} |
CH2=CH2 |
\t |
≡ | {{chem2|HC\tCH}} |
HC≡CH |
\q |
≣ | {{chem2|[Cl4Re\qReCl4](2−)}} |
[Cl4Re≣ReCl4]2− |
\- |
- | {{chem2|A\-B}} |
A-B |
\\ |
\ | {{chem2|C\\D}} |
C\D |
\h |
η | {{chem2|\h}} |
η |
\h{1} |
η1- | {{chem2|\h{1} |}} |
η1- |
\m{1} |
μ1- | {{chem2|\m{1} |}} |
μ1- |
-> |
→ | {{chem2|2H2 + O2 -> 2H2O}} |
2H2 + O2 → 2H2O |
<-> |
⇌ | {{chem2|K<->L}} |
K ⇌ L |
* |
· | {{chem2|CoCl2*6H2O}} |
CoCl2·6H2O |
\* |
* | {{chem2|Cp\*2Fe}} |
Cp*2Fe |
_{} |
subscript | {{chem2|C_{''n''}H_{2''n''+2} }} |
CnH2n+2 |
^{} |
superscript | {{chem2|^{13}CH4}} |
13CH4 |
∇ |
∇ | {{chem2|∇}} |
∇ |
( ) |
( ) | {{chem2|R\sCH(OH)CN}} |
R−CH(OH)CN |
end }-bracket issue
When input ends correctly with a }-bracket, like with A_{x}H_{1-x}
, the final }-brackets are technically mixed up:
{{chem2|A_{x}H_{1-x}}}
→ AxH_{−1x}
The closing bracket }
of input and end of template brackets }}
are interpreted by Wikipedia software in reversed order.
- Solutions:
- add empty pipe:
{{chem2|...{...}|}}
(empty parameter #2) - add parameters numbers 1 and 2 (empty):
{{chem2|1=...{...}|2=}}
- add a space:
{{chem2|...{...} }}
- add empty pipe:
- Result:
{{chem2|A_{x}H_{1-x}|}}
→ AxH1−x
Formulas, charges, equations
Formulas (without charge) are just written:
{{chem2|CH3(CH2)5CH3}}
→ CH3(CH2)5CH3{{chem2|Fe3S2(CO)9}}
→ Fe3S2(CO)9{{chem2|C_{''n''}H_{2''n''+2}|}}
→ CnH2n+2
Charges are written inside parentheses:
{{chem2|SO4(2-)}}
→ SO2−4{{chem2|S19(2+)}}
→ S2+19
Charges +1 and −1 can be written plain:
{{chem2|Na+}}
→ Na+{{chem2|O2-}}
→ O−2
- same as
{{chem2|O2(-)}}
→ O−2
Chemical equations:
{{chem2|2 S + 3 O2 + 2 H2O -> 2 H2SO4}}
→ 2 S + 3 O2 + 2 H2O → 2 H2SO4{{chem2|2S + 3O2 + 2H2O -> 2H2SO4}}
→ 2S + 3O2 + 2H2O → 2H2SO4
The arrows can be written as ->
or just →
. All characters (and unicode markup) are valid input except \
, = (Mediawiki use it), _
and -
(endash etc.)
{{chem2|2 H2(g) + O2(g) -> 2H2O(g)|}}
→ 2 H2(g) + O2(g) → 2H2O(g){{chem2|NH2RCHCO2H <-> NH3+RCHCO2-}}
→ NH2RCHCO2H ⇌ NH+3RCHCO−2
Hapticity and mu:
{{chem2|W(CO)3(PiPr3)2(\h{2}H2)}}
→ W(CO)3(PiPr3)2(η2-H2){{chem2|W(CO)3(PiPr3)2(\h{2}H2)|auto=yes}}
→ W(CO)3(PiPr3)2(η2-H2)
Wikilinks
As of March 2023[update], {{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 |link=<wiki pagename>
:
{{chem2|FeCl3|link=Iron(III) chloride}}
→ FeCl3
Or use wikilink brackets in input like [[ammonia|NH3]]
:
Link each element (C, Hg) and generic element code (R, X)
Use |auto=yes
to link from the first occurrence of each element symbol, and some functional-group symbols such as Ph
Link functional groups
Some common groups are recognized and linked if you wikilink them using [[ ]]
{{chem2|R\-[[COOH]]}}
→ R-COOH{{chem2|[[CH3]]C[[R]]2[[I]]}}
→ CH3CR2I- In particular H2O links to water of crystallization in
{{chem2|CuSO4 * 5 [[H2O]]}}
→ CuSO4 · 5 H2O, because a link to water is generally unnecessary.
You can link to any article even if chem2 is unaware of it:
{{chem2|[[C6H5NH2]]}}
→ C6H5NH2
To change the default link:
{{chem2|[[water|H2O]]}}
→ H2O
All recognised symbols and codes
Examples and tests
(The first "→" in each example is not part of the output; it separates the example from its output.)
{{chem2|[Cl4Re\qReCl4](2-)|}}
→ [Cl4Re≣ReCl4]2−{{chem2|NH2RCHCO2H <-> NH3+RCHCO2−}}
→ NH2RCHCO2H ⇌ NH+3RCHCO−2
{{chem2|\\hallo}}
→ \hallo{{chem2|H3CC\tCH <-> H2C\dC\dCH2}}
→ H3CC≡CH ⇌ H2C=C=CH2{{chem2|4 NH3 + 5 O2 -> 4 NO + 6 H2O}}
→ 4 NH3 + 5 O2 → 4 NO + 6 H2O
{{chem2|H2O → H2O}}
→ H2O → H2O{{chem2|H2O(l) -> H2O(g)}}
→ H2O(l) → H2O(g)
{{chem2|4 NH3 + 5 O2 → 4 NO + 6 H2O}}
→ 4 NH3 + 5 O2 → 4 NO + 6 H2O{{chem2|4NH3 + 5O2 → 4NO + 6H2O}}
→ 4NH3 + 5O2 → 4NO + 6H2O{{chem2|2Mn2(+)}}
→ 2Mn+2{{chem2|2Mn2(+) + 3H2O}}
→ 2Mn+2 + 3H2O{{chem2|Mn–}}
→ Mn−
{{chem2|Mn2(2-)}}
→ Mn2−2{{chem2|Mn2☃+}}
→ Mn2☃+;{{chem2|Mn2(2☃–)}}
→ Mn2(2☃−){{chem2|Mn2(+)}}
→ Mn+2{{chem2|Mn2+}}
→ Mn+2{{chem2|Mn2(-)}}
→ Mn−2{{chem2|Mn2-}}
→ Mn−2
{{chem2|C_{''n''}H_{2''n'' + 2}|}}
→ CnH2n + 2- (chem:
{{chem|C|''n''|H|2''n'' + 2}}
→ C
nH
2n + 2 {{chem2|C_{abc}|}}
→ Cabc{{chem2|CoCl2*1.5H2O}}
→ CoCl2·1.5H2O{{chem2|Cu2C2*H2O}}
→ Cu2C2·H2O
Special
{{chem2|[Me2Al(\m{2}Me)]2}}
→ [Me2Al(μ2-Me)]2{{chem2|^{13}CO2}}
→ 13CO2{{chem2|^{13}CO2|auto=yes}}
→ 13CO2{{chem2|\h{5}(C5H5)2TiCl2}}
→ η5-(C5H5)2TiCl2- (bad)
{{chem2|\h{5}\s(C5H5)2TiCl2}}
→ η5-−(C5H5)2TiCl2 {{chem2|CH2\dCH2\sCH2\sC\tCH\qMn}}
→ CH2=CH2−CH2−C≡CH≣Mn
{{chem2|RC(OR')3}}
→ RC(OR')3{{chem2|C\\C}}
→ C\C{{chem2|C2*NH3}}
→ C2·NH3{{chem2|C2*2NH3}}
→ C2·2NH3{{chem2|C1.2H3.5}}
→ C1.2H3.5
{{chem2|\b\bAbC\e\e}}
→ AbC{{chem2|C2(μ\-C)}}
→ C2(μ-C)
{{chem2|SO4(2-)}}
→ SO2−4{{chem2|2Mn2(2+)}}
→ 2Mn2+2{{chem2|CH3-CH2-OH}}
→ CH−3CH−2OH{{chem2|[ZnCl4]-}}
→ [ZnCl4]−{{chem2|[ZnCl4](2-)}}
→ [ZnCl4]2−{{chem2|((H2O)5{CoCl2})2|auto=yes}}
→ ((H2O)5{CoCl2})2{{chem2|Si(OH)4}}
→ Si(OH)4
{{chem2|Cu2C2*H2O|auto=yes}}
→ Cu2C2·H2O{{chem2|Cu2C2*2H2O}}
→ Cu2C2·2H2O{{chem2|CuSO*2H2O}}
→ CuSO·2H2O{{chem2|CuSO4*15H2O}}
→ CuSO4·15H2O{{chem2|CuSO4(H2O)5}}
→ CuSO4(H2O)5{{chem2|H+ + OH- → H2O}}
→ H+ + OH− → H2O{{chem2|H → O}}
→ H → O
{{chem2|ZxPo4}}
→ ZxPo4 Unknown element.{{chem2|((Na)Cl}}
→ ((Na)Cl Too many "(".{{chem2|Si(OH))4}}
→ Si(OH))4 Too many ")".{{chem2|Si&[[☃]]Si}}
→ Si&☃Si{{chem2|1=CH2=CH2}}
→ CH2=CH2
More
{{chem2|Cl2O6|link=dichlorine hexoxide}}
→ Cl2O6{{chem2|[Fe(Phen)(Phen)3](2+)}}
→ [Fe(Phen)(Phen)3]2+{{chem2|[Fe(Phen)(Phen)3](2+)|auto=yes}}
→ [Fe(Phen)(Phen)3]2+{{chem2|[C2O2](2+)}}
→ [C2O2]2+{{chem2|SI4|link=Tomato}}
→ SI4{{chem2|H2SO4+}}
→ H2SO+4{{chem2|Mn-}}
→ Mn−{{chem2|Mn22+}}
→ Mn+22,{{chem2|Mn22-}}
→ Mn−22{{chem2|Mn(2+)}}
→ Mn2+{{chem2|Mn2(+)}}
→ Mn+2{{chem2|Mn(22-)}}
→ Mn22−{{chem2|Mn3(22-)}}
→ Mn22−3{{chem2|Mn(22+)}}
→ Mn22+{{chem2|Mn2(22+)}}
→ Mn22+2{{chem2|Mn2(2+)}}
→ Mn2+2{{chem2|Mn22(2+)}}
→ Mn2+22
Chem vs chem2
{{chem|(CH|3|)|2|CO}}
→ (CH
3)
2CO{{chem2|(CH3)2CO}}
→ (CH3)2CO{{chem|H|2|+}}
→ H+
2{{chem2|H2+}}
→ H+2
Predefined codes (groups etc.)
Predefined codes | ||||
---|---|---|---|---|
code | target article | {{chem2|code}}
|
type | note |
A. Groups etc with element-like names | ||||
Bz | Benzoyl group | Bz | A: wl |auto=yes
|
|
Et | Ethyl group | Et | A: wl |auto=yes
|
|
Ln | Lanthanide | Ln | A: wl |auto=yes
|
|
Nu | Nucleophile | Nu | A: wl |auto=yes
|
|
Ph | Phenyl group | Ph | A: wl |auto=yes
|
|
R | Substituent | R | A: wl |auto=yes
|
|
T | Tritium | T | A: wl |auto=yes
|
|
Tf | Trifluoromethylsulfonyl group | Tf | A: wl |auto=yes
|
|
X | Halogen | X | A: wl |auto=yes
|
|
B. Groups which are redirected from their normal target if wikilinked; never autolinked. | ||||
CH3 | Methyl group | CH3 | B: wl |..[[code]]..
|
|
CO3 | Carbonate | CO3 | B: wl |..[[code]]..
|
|
COOH | Carboxyl group | COOH | B: wl |..[[code]]..
|
|
ClO | Hypochlorite | ClO | B: wl |..[[code]]..
|
|
ClO2 | Chlorite | ClO2 | B: wl |..[[code]]..
|
|
ClO3 | Chlorate | ClO3 | B: wl |..[[code]]..
|
|
ClO4 | Perchlorate | ClO4 | B: wl |..[[code]]..
|
|
H2O | Water of crystallization | H2O | B: wl |..[[code]]..
|
|
H3O | Hydronium | H3O | B: wl |..[[code]]..
|
|
NH2 | Amine group | NH2 | B: wl |..[[code]]..
|
|
NH4 | Ammonium | NH4 | B: wl |..[[code]]..
|
|
NO3 | Nitrate | NO3 | B: wl |..[[code]]..
|
|
PO3 | Phosphite | PO3 | B: wl |..[[code]]..
|
|
PO4 | Phosphate | PO4 | B: wl |..[[code]]..
|
|
SH | Thiol group | SH | B: wl |..[[code]]..
|
|
SO3 | Sulfite | SO3 | B: wl |..[[code]]..
|
|
SO4 | Sulfate | SO4 | B: wl |..[[code]]..
|
|
SeH | Selenol group | SeH | B: wl |..[[code]]..
|
TemplateData
TemplateData for Chem2
No description.
Parameter | Description | Type | Status | |
---|---|---|---|---|
1 | 1 | no description | Unknown | optional |
auto | auto | no description | Unknown | optional |
link | link | no description | Unknown | optional |
Tracking
See also
- {{Chem}}
- <chem>: WP:MATHCHEM — by TeX