Our job descriptions can be written using HTML, markdown, or a mix of the two. We've created this page to showcase the options you have and to provide you copy and pastable examples. If you'd like you can skip to the bottom of the page, which has a long job description example using many of the examples listed below.Here is a download link for a pdf version of this page for future reference.
For security reasons, we limit the HTML elements that can be used in a job description to the list below.
HTML Tag | Description | Example | Code |
---|---|---|---|
<a> | Defines a hyperlink. (can have href, and title attributes) | <a href="https://example.com" title="example link">This link goes to example.com</a> | |
<b> | Defines bold text | Bold Text | <b>Bold Text</b> |
<blockquote> | Defines a secion that is quoted from another source | This could be a quote from somewhere else | <blockquote>This could be a quote from somewhere else</blockquote> |
<br> | Defines a single line break |
Line 1 textLine 2 text
| Line 1 text</br>Line 2 text |
<center> | Defines centered text | <center>This text is centered</center> | |
<code> | Defines a piece of computer code | answer = function(x, y) | <code>answer = function(x, y)</code> |
<del> | Defines text that has been deleted from a document | <del>This text is crossed out</del> | |
<em> | Defines emphasized text | This text is emphasized | <em>This text is emphasized</em> |
<hr> | Defines a thematic change in content |
Line 1 text Line 2 text | Line 1 text<hr>Line 2 text |
<h1/h2/h3/h4/h5> | Defines headings of decreasing size | Heading 1Heading 2Heading 3Heading 4Heading 5 | <h1>Heading 1</h1> <h2>Heading 2</h2> <h3>Heading 3</h3> <h4>Heading 4</h4> <h5>Heading 5</h5> |
<i> | Defines italicized text | This text is italicized | <i>This text is italicized</i> |
<img> | Defines an image. (can have src, width, height, alt, and title attributes). | ![]() | <img src="https://homepages.cae.wisc.edu/~ece533/images/peppers.png" width=200 height=200 alt="An image of peppers" title="Peppers"/> |
<kbd> | Defines keyboard input text, which has a unique highlight to it | This text is highlighted | <kbd>This text is highlighted</kbd> |
<ul/li> | Defines an unordered list of elements |
| <ul> <li>list item 1</li> <li>list item 2</li> </ul> |
<ol/li> | Defines an ordered list of elements |
| <ol> <li>list item 1</li> <li>list item 2</li> </ol> |
<p> | Defines a paragraph of text | This text is in a paragraph | <p>This text is in a paragraph</p> |
<pre> | Defines preformatted text | This text has been preformatted | <pre>This text has been preformatted</pre> |
<s> | Defines text with a strike through it | <s>This text has been crossed out</s> | |
<sup> | Defines superscripted text |
Normal textsuperscripted text | Normal text<sup>superscripted text</sup> |
<strong> | Defines important text | This text has an emphasis to it | <strong>This text has an emphasis to it</strong> |
<strike> | Defines text with a strike through it | <strike>This text has been crossed out</strike> |
Markdown is a lighter weight markup language, compared to HTML. It can be easier to write, but may have less options than HTML would have.
Markdown Symbol | Description | Example | Code |
---|---|---|---|
# | Headers allow you to resize text for titles | Header 1Header 2Header 3Header 4Header 5Header 6 | # Header 1 ## Header 2 ### Header 3 #### Header 4 ##### Header 5 ###### Header 6 |
* | Italics let you emphasize certain text | This text is italicized | *This text is italicized* _This text is italicized_ |
** | Bold lets you emphasize certain text | This text is in bold | **This text is in bold** __This text is in bold__ |
~ | Strikethrough can let you show edited, or incorrect text | ~~This text is striked through~~ | |
1. | Lists can be used to organize information in a readable way |
| 1. Item 1 2. Item 2 3. Item 3 |
+ | Unordered lists don't use numbers to represent unordered data |
| + Item 1 + Item 2 + Item 3or * Item 1 * Item 2 * Item 3or - Item 1 - Item 2 - Item 3 |
[]() | Links can be added with any text | [some link](https://example.com) | |
![]() | Images can be added with alt text and title text | ![]() |  |
> | Text can be quoted to show it's from another source | some text | > some text |
--- | A big line can be placed between sections of your description |
Top Text Bottom Text | Top Text --- Bottom Text |
Some kind of description of your company, and what you are about.A link to the company page so the candidate can find out more. Maybe you have a company motto you'd like to draw attention too.
A description of what this job is, and details that will let the candidate know if it is a good fit for them or not. You might try emphasizing certain key words you think would interest potential candidates.
It would be a good idea to list out what would be expected of the candidate in a more orderly fashion.
It should be made clear what level of qualification a candidate should have for this position.
<h3>Fake Company Name</h3> <hr> <p> Some kind of description of your company, and what you are about.</br> <a href="https://example.com">A link to the company page</a> so the candidate can find out more.</br> Maybe you have a <i>company motto</i> you'd like to draw attention too. </p> <h3>Job Description</h3> <hr> <p> A description of what this job is, and details that will let the candidate know if it is a good fit for them or not.</br> You might try emphasizing certain <b>key words</b> you think would interest potential candidates. </p> <h3>Responsibilities</h3> <hr> <p> It would be a good idea to list out what would be expected of the candidate in a more orderly fashion. <ul> <li>Work within the team to acheive some goals</li> <li>Provide your unique vision to the company, expanding it's horizons</li> <li>Manage others, and help them understand and work through problems</li> </ul> </p> <h3>Qualifications</h3> <hr> <p> It should be made clear what level of qualification a candidate should have for this position. <ol> <li>5 years working with some tool</li> <li>Basic knowledge with some other tool</li> <li>A bachelor's degree in something</li> </ol> </p>