Template:Chem2/doc

{{chem2}} (or {{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|CH4_{(g)} |}} § {}	CH4(g)
^{}	superscript	{{chem2|^{13}CH4}}	13CH4
&nabla;	∇	{{chem2|&nabla;}}	∇
( )	( )	{{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}}} → A_xH_{−1x} N

The closing bracket {..} of input and end of temlate brackets }}.

• Solutions:

add empty pipe: {{chem2|..{..}|}} (empty parameter #2)

add parameters numbers 1 and 2 (empty): {{chem2|1=..{..}|2=}}

add a space: {{chem2|..{..} }}

Result: {{chem2|A_{x}H_{1-x} |}} → A_xH_1−x Y

Formulas, charges, equations

Formulas (without charge) are just written:

• {{chem2|CH3(CH2)5CH3}} → CH₃(CH₂)₅CH₃
• {{chem2|Fe3S2(CO)9}} → Fe₃S₂(CO)₉
• {{chem2|C_{''n''}H_{2''n''+2}|}} → C_nH_2n+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

equals {{chem2|O2(-)}}

Chemical equations:

• {{chem2|2 S + 3 O2 + 2 H2O -> 2 H2SO4}} → 2 S + 3 O₂ + 2 H₂O → 2 H₂SO₄
• {{chem2|2S + 3O2 + 2H2O -> 2H2SO4}} → 2S + 3O₂ + 2H₂O → 2H₂SO₄

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 H_2(g) + O_2(g) → 2H₂O_(g)
• {{chem2|NH2RCHCO2H <-> NH3+RCHCO2-}} → NH₂RCHCO₂H ⇌ NH+3RCHCO−2

Hapticity and mu:

• {{chem2|W(CO)3(PiPr3)2(\h{2}H2)}} → W(CO)₃(PiPr₃)₂(η²-H₂)
• {{chem2|auto=yes|W(CO)3(PiPr3)2(\h{2}H2)}} → W(CO)₃(PiPr₃)₂(η²-H₂)

Wikilinks

Whole formula link

Link the whole formula with |link=<wiki pagename>:

• {{chem2|FeCl3|link=Iron(III) chloride}} → FeCl₃

Or use wikilink brackets in input like [[ammonia|NH3]]:

• {{chem2|3[[hydrogen|H2]] + 2[[nitrogen|N2]] <-> 2[[ammonia|NH3]]}} → 3H₂ + 2N₂ ⇌ 2NH₃

Link each element (C, Hg) and generic element code (R, X)

Use |auto=yes to link each element symbol once, as well as some others such as Ph

• {{chem2|CH3CH2CH3CBrFCIClCH3|auto=yes}} → CH₃CH₂CH₃CBrFCIClCH₃

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]]}} → CH₃CR₂I
• In particular H2O links to water of crystallization in {{chem2|CuSO4 * 5 [[H2O]]}} → CuSO₄ · 5 H₂O, because a link to water is generally unnecessary.

You can link to any article even if chem2 is unaware of it:!-- same as |link=... then -->

• {{chem2|[[C6H5NH2]]}} → C₆H₅NH₂

To change the default link:

• {{chem2|[[water|H2O]]}} → H₂O

All recognised symbols and codes

All link targets recognised by {{chem2}} (elements, general codes, functional groups)

Elements and element-style symbols These may be automatically linked or used as if they were redirects. Symbol Link target Ac Actinium Ag Silver Al Aluminium Am Americium Ar Argon As Arsenic At Astatine Au Gold B Boron Ba Barium Be Beryllium Bh Bohrium Bi Bismuth Bk Berkelium Bn Benzyl group Br Bromine Bz Benzoyl group C Carbon Ca Calcium Cd Cadmium Ce Cerium Cf Californium Cl Chlorine Cm Curium Co Cobalt Cp Copernicium Cr Chromium Cs Caesium Cu Copper D Deuterium Db Dubnium Ds Darmstadtium Dy Dysprosium Er Erbium Es Einsteinium Et Ethyl group Eu Europium F Fluorine Fe Iron Fl Flerovium Fm Fermium Fr Francium Ga Gallium Gd Gadolinium Ge Germanium H Hydrogen He Helium Hf Hafnium Hg Mercury (element) Ho Holmium Hs Hassium I Iodine In Indium Ir Iridium K Potassium Kr Krypton La Lanthanum Li Lithium Ln Lanthanide Lr Lawrencium Lu Lutetium Lv Livermorium Mc Moscovium Md Mendelevium Mg Magnesium Mn Manganese Mo Molybdenum Mt Meitnerium N Nitrogen Na Sodium Nb Niobium Nd Neodymium Ne Neon Nh Nihonium Ni Nickel No Nobelium Np Neptunium Nu Nucleophile O Oxygen Og Oganesson Os Osmium P Phosphorus Pa Protactinium Pb Lead Pd Palladium Ph Phenyl group Pm Promethium Po Polonium Pr Praseodymium Pt Platinum Pu Plutonium R Substituent Ra Radium Rb Rubidium Re Rhenium Rf Rutherfordium Rg Roentgenium Rh Rhodium Rn Radon Ru Ruthenium S Sulfur Sb Antimony Sc Scandium Se Selenium Sg Seaborgium Si Silicon Sm Samarium Sn Tin Sr Strontium T Tritium Ta Tantalum Tb Terbium Tc Technetium Te Tellurium Tf Trifluoromethylsulfonyl group Th Thorium Ti Titanium Tl Thallium Tm Thulium Ts Tennessine U Uranium V Vanadium W Tungsten X Halogen Xe Xenon Y Yttrium Yb Ytterbium Zn Zinc Zr Zirconium Groups These must be linked manually; they work as if they were redirects. Symbol Link target CH3 Methyl group CO3 Carbonate COOH Carboxyl group ClO Hypochlorite ClO2 Chlorite ClO3 Chlorate ClO4 Perchlorate H2O Water of crystallization H3O Hydronium NH2 Amine group NH4 Ammonium NO3 Nitrate PO3 Phosphite PO4 Phosphate SH Thiol group SO3 Sulfite SO4 Sulfate SeH Selenol group

Examples

• {{chem2|[Cl4Re\qReCl4](2−)|}} gives [Cl₄Re≣ReCl₄]²⁻
• {{chem2|[Cl4Re\qReCl4](2-)|}} gives [Cl₄Re≣ReCl₄]²⁻
• {{chem2|NH2RCHCO2H <-> NH3+RCHCO2−}} gives NH₂RCHCO₂H ⇌ NH+3RCHCO−2

---

• {{chem2|\\hallo}} gives \hallo
• {{chem2|H3CC\tCH <-> H2C\dC\dCH2}} gives H₃CC≡CH ⇌ H₂C=C=CH₂
• {{chem2|4 NH3 + 5 O2 -> 4 NO + 6 H2O}} gives 4 NH₃ + 5 O₂ → 4 NO + 6 H₂O

---

• "H2O → H2O" is H₂O → H₂O
• "H2O_{(l)} -> H2O_{(g)}" is H₂O_(l) → H₂O_(g)

---

• "4 NH3 + 5 O2 → 4 NO + 6 H2O" is 4 NH₃ + 5 O₂ → 4 NO + 6 H₂O
• " 4 NH3 + 5 O2 → 4 NO + 6 H2O" is 4 NH₃ + 5 O₂ → 4 NO + 6 H₂O
• " 4NH3 + 5O2 → 4NO + 6H2O" is 4NH₃ + 5O₂ → 4NO + 6H₂O
• " 2Mn2(+)" is 2Mn+2
• " 2Mn2(+) + 3H2O" is 2Mn+2 + 3H₂O
• Mn– is Mn⁻

---

• Mn2(2-) is Mn2−2
• Mn2☃+ is Mn₂☃⁺, Mn2(2–) is Mn2−2, Mn2(2☃–) is Mn₂(₂☃⁻)
• Mn2(+) is Mn+2
• Mn2+ is Mn+2
• Mn2(-) is Mn−2
• Mn2- is Mn−2

---

• {{chem2|C_{''n''}H_{2''n'' + 2}|}} gives C_nH_2n + 2
• {{chem2|C_{abc}|}} gives C_abc
• (chem gives C
  _nH
  _2n + 2)
• {{chem2|CoCl2*1.5H2O}} gives CoCl₂·1.5H₂O
• Mn22– is Mn−22
• Cu2C2*H2O is Cu₂C₂·H₂O

---

Special

• {{chem2|[Me2Al(\m{2}Me)]2}} gives [Me₂Al(μ₂-Me)]₂
• {{chem2|^{13}CO2}} gives ¹³CO₂
• {{chem2|auto=yes|^{13}CO2}} gives ¹³CO₂
• {{chem2|\h{5}(C5H5)2TiCl2}} gives η⁵-(C₅H₅)₂TiCl₂
• {{chem2|\h{5}\s(C5H5)}} gives η⁵-−(C₅H₅)
• {{chem2|CH2\dCH2\sCH2\sC\tCH\qMn}} is CH₂=CH₂−CH₂−C≡CH≣Mn

---

• {{chem2|RC(OR’)3}} gives RC(OR’)₃
• {{chem2|C\\C}} gives C\C
• {{chem2|C2*NH3}} gives C₂·NH₃
• {{chem2|C2*2NH3}} gives C₂·2NH₃
• {{chem2|C1.2H3.5}} gives C_1.2H_3.5

---

• {{chem2|\{\{abc\}\}}} is AbC
• C2(μ\-C) is C₂(μ-C)

---

• SO4(2-) is SO2−4
• 2Mn2(2+) is 2Mn2+2
• CH3-CH2-OH is CH−3CH−2OH
• [ZnCl4]- is [ZnCl₄]⁻
• [ZnCl4](2-) is [ZnCl₄]²⁻
• AUTO: ((H2O)5{CoCl2})2 is ((H₂O)₅{CoCl₂})₂
• Si(OH)4 is Si(OH)₄

---

• AUTO: Cu2C2*H2O is Cu₂C₂·H₂O
• Cu2C2*2H2O is Cu₂C₂·2H₂O
• CuSO*2H2O is CuSO·2H₂O
• CuSO4*15H2O is CuSO₄·15H₂O
• CuSO4(H2O)5 is CuSO₄(H₂O)₅
• H+ + OH- → H2O is H⁺ + OH⁻ → H₂O
• H → O is H → O

---

• ZxPo4 is ZxPo₄     Unknown element.
• ((Na)Cl is ((Na)Cl     Too many "(".
• Si(OH))4 is Si(OH))₄     Too many ")".
• Si&☃Si is Si&☃Si
• CH₂=CH₂

More

• {{chem2|Cl2O6|link=dichlorine hexoxide}} is Cl₂O₆
• [Fe(Phen)(Phen)3](2+) is [Fe(Phen)(Phen)₃]²⁺
• AUTO: [Fe(Phen)(Phen)3](2+) is [Fe(Phen)(Phen)₃]²⁺
• {{chem2|[C2O2](2+)}} is [C₂O₂]²⁺
• {{chem2|link=Tomato|SI4}} is SI₄
• H2SO4+ is H₂SO+4
• Mn- is Mn⁻
• Mn22+ is Mn+22, Mn22- is Mn−22,
• Mn(2+) is Mn²⁺
• Mn2(+) is Mn+2
• Mn(22-) is Mn²²⁻
• Mn3(22-) is Mn22−3
• Mn(22+) is Mn²²⁺
• Mn2(22+) is Mn22+2
• Mn2(2+) is Mn2+2
• Mn22(2+) is Mn2+22

Chem vs chem2

• (CH
  ₃)
  ₂CO     Chem
• (CH₃)₂CO     Chem2
• H⁺
  ₂     Chem
• H+2     Chem2

Predefined codes (groups etc.)

Predefined codes
code	target article	{{Chem2|code}}	type	note
A. Groups etc with element-like names
Bz	Benzoyl group	Bz	auto=yes
Et	Ethyl group	Et	auto=yes
Ln	Lanthanide	Ln	auto=yes
Nu	Nucleophile	Nu	auto=yes
Ph	Phenyl group	Ph	auto=yes
R	Substituent	R	auto=yes
T	Tritium	T	auto=yes
Tf	Trifluoromethylsulfonyl group	Tf	auto=yes
X	Halogen	X	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

This is the TemplateData documentation for this template used by VisualEditor and other tools.

Chem2

No description.

Template parameters

Parameter		Description	Type	Status
1	1	no description	Unknown	optional
auto	auto	no description	Unknown	optional
link	link	no description	Unknown	optional

Tracking

• Category:Pages using Chem2 with parameter issues (0)

See also

• {{Chem}}
• <chem>, WP:MATHCHEM — by TeX