View source for Template:Chem/doc

{{Documentation subpage}}
{{COinS safe|n}}
This template allows you to render chemical formulas using HTML. Alternatively, you can use {{tag|chem}}, using [[Help:Displaying_a_formula#Chemistry|mhchem LaTeX]] notation to generate formulas. 

<div style="clear: both;"></div>
==Template instructions==
This template, {{Tl|chem}}, serves to simplify the writing of chemical formulas. For example,
<pre>
{{chem|H|2|O}}
</pre>
will yield:
: {{chem|H|2|O}}

===Algebraic expression as subscript===
Algebraic expressions are rendered as subscripts (but must not contain upper case letters).
<pre>
{{chem|C|''n''|H|2''n''&amp;nbsp;+&amp;nbsp;2}}
</pre>
gives
: {{chem|C|''n''|H|2''n''&nbsp;+&nbsp;2}}

===Charge===
Ion charge superscripts (for: +/-) are also supported:
<pre>
{{chem|H|3|O|+}}
</pre>
yields a "+" as superscript:
: {{chem|H|3|O|+}}

Simultaneous subscripts/superscripts are automatically handled (use a hyphen for the minus sign):
<pre>
{{chem|SO|4|2-}}
</pre>
gives "2−" as superscript:
: {{chem|SO|4|2-}}
The hyphen is converted to a true minus sign.

===Atomic number and mass number===
The first parameter can be used for mass number.
<pre>
{{chem|4|He}}
</pre>
gives:
: {{chem|4|He}}

The first two parameters can be used for mass number and atomic number.
<pre>
{{chem|4|2|He}}
</pre>
gives:
: {{chem|4|2|He}}

;Note: 
:Only the first two parameters can handle two consecutive plain numbers (i.e. without a plus sign or a hyphen (<code>+</code> or <code>-</code>) following). Otherwise the template will loop. The [[Template:Chem2|Chem2 template]] can be used for e.g. {{chem2|^{1}H2^{16}O}}, heavy water.

;See also {{tl|Nuclide|}}

===Linking===
The optional parameter <kbd>link</kbd> changes the formula into a link. For example:
<pre>
{{chem|link=water|H|2|O}}
</pre>
will yield:
: {{chem|link=water|H|2|O}}

Individual elements can be linked in the following manner:
<pre>
{{chem|[[Hydrogen|H]]|2|[[Oxygen|O]]}} 
</pre>
gives 
: {{chem|[[Hydrogen|H]]|2|[[Oxygen|O]]}}

==Notes==
*To include "=" in the formula, use "&amp;#61;" For example, "<nowiki>{{chem|CH|2|&amp;#61;CH|2}}</nowiki>" yields {{chem|CH|2|&#61;CH|2}}.<!-- AWKWARD, ISN'T IT? -->
**Or, don't use this template. For example, "<nowiki>CH<sub>2</sub>=CH<sub>2</sub></nowiki>" yields CH<sub>2</sub>=CH<sub>2</sub>.
*To include "≡" in the formula, use "&amp;#8801;" For example, "<nowiki>{{chem|HC&amp;#8801;CH}}</nowiki>" yields {{chem|HC&#8801;CH}}.<!-- AWKWARD, ISN'T IT? -->
*The template accepts up to twenty parameters in addition to <code>link</code>.
*This template uses {{tl|su}}.

==See also==
* {{tl|Chem2}}
* {{tl|Chem molar mass}}

== TemplateData ==
{{TemplateData header}}
{{collapse top|title=Template data|bg=#ccc}}
<templatedata>
{
	"params": {
		"1": {},
		"2": {},
		"3": {},
		"4": {},
		"5": {},
		"6": {},
		"7": {},
		"8": {},
		"9": {},
		"10": {},
		"11": {},
		"12": {},
		"13": {},
		"14": {},
		"15": {},
		"16": {},
		"17": {},
		"18": {},
		"19": {},
		"20": {},
		"21": {},
		"22": {},
		"23": {},
		"24": {},
		"link": {
			"label": "Link",
			"description": "Make the formula link to an article",
			"example": "Water",
			"type": "wiki-page-name"
		}
	},
	"description": "Render chemical formulas using HTML. Alternatively, you can use <chem>...</chem>, using mhchem LaTeX notation to generate formulas.\n\nUp to 25 unnamed ordered parameters can be used with automatic detection of subscripts and superscripts.",
	"format": "inline",
	"paramOrder": [
		"link",
		"1",
		"2",
		"3",
		"4",
		"5",
		"6",
		"7",
		"8",
		"9",
		"10",
		"11",
		"12",
		"13",
		"14",
		"15",
		"16",
		"17",
		"18",
		"19",
		"20",
		"21",
		"22",
		"23",
		"24"
	]
}
</templatedata>
{{collapse bottom}}
<includeonly>{{sandbox other||
[[Category:Text-specific formatting and function templates]]
[[Category:Chemistry formatting and function templates]]
[[Category:Superscript and subscript templates]]
}}</includeonly>