Esta tradução está incompleta. Por favor, ajude a traduzir este artigo do Inglês.

HTML (Linguagem de Marcação de Hipertexto) é o código que é utilizado para estruturar uma página da Web e o seu conteúdo. Por exemplo, o conteúdo poderá ser estruturado dentro de um conjunto de parágrafos, uma lista de pontos com marcadores, ou utilizando imagens e tabelas de dados. Como o título sugere, este artigo irá dar-lhe uma compreensão básica do HTML e as suas funções.

Então, o que é realmente o HTML?

HTML não é uma linguagem de programação; esta é uma linguagem de marcação que define a estrutura do seu conteúdo. HTML consiste numa série de elementos, que utiliza para incluir diferentes partes do conteúdo para fazê-lo aparecer de uma certa maneira, ou agir de uma certa maneira. A inclusão de etiquetas pode interligar as palavras ou imagens em outro lugar, colocar as palavras em itálico, e pode tornar o tipo de letra maior ou menor, e assim por diante. Por exemplo, veja a seguinte linha de conteúdo:

My cat is very grumpy

If we wanted the line to stand by itself, we could specify that it is a paragraph by enclosing it in paragraph tags:

<p>My cat is very grumpy</p>

Anatomia de um elemento HTML

Vamos explorar este elemento de parágrafo um pouco mais.

As principais partes do nosso elemento são:

  1. A etiqueta de abertura: This consists of the name of the element (in this case, p), wrapped in opening and closing angle brackets. This states where the element begins, or starts to take effect — in this case where the start of the paragraph is.
  2. A etiqueta de fecho: This is the same as the opening tag, except that it includes a forward slash before the element name. This states where the element ends — in this case where the end of the paragraph is. Failing to include a closing tag is one of the common beginner errors and can lead to strange results.
  3. O conteúdo: This is the content of the element, which in this case is just text.
  4. O elemento: The opening tag plus the closing tag plus the content equals the element.

Elementos podem também ter atributos, o que se parece assim:

Attributes contain extra information about the element that you don't want to appear in the actual content. Here, class is the attribute name, and editor-note is the attribute value. The class attribute allows you to give the element an identifier that can be later used to target the element with style information and other things.

Um atributo deve ter sempre:

  1. Um espaço entre si o nome do elemento (ou do atributo anterrior, se esse elemento já possuir um ou mais atributos).
  2. O nome do atributo, seguido de um símbolo de igual.
  3. Aspas de abertura e fecho à volta do nome do atributo

Encadear elementos

You can put elements inside other elements too — this is called nesting. If we wanted to state that our cat is very grumpy, we could wrap the word "very" in a <strong> element, which means that the word is to be strongly emphasized:

<p>My cat is <strong>very</strong> grumpy.</p>

You do however need to make sure that your elements are properly nested: in the example above we opened the <p> element first, then the <strong> element, therefore we have to close the <strong> element first, then the <p>. The following is incorrect:

<p>My cat is <strong>very grumpy.</p></strong>

The elements have to open and close correctly so they are clearly inside or outside one another. If they overlap like above, then your web browser will try to make a best guess at what you were trying to say, and you may well get unexpected results. So don't do it!

Elementos vazios

Some elements have no content, and are called empty elements. Take the <img> element we already have in our HTML:

<img src="images/firefox-icon.png" alt="My test image">

This contains two attributes, but there is no closing </img> tag, and no inner content. This is because an image element doesn't wrap content to have an effect on it. Its purpose is to embed an image in the HTML page in the place it appears.

Anatomia de um documento HTML

That wraps up the basics of individual HTML elements, but they aren't very useful on their own. Now we'll look at how individual elements are combined to form an entire HTML page. Let's revisit the code we put into our index.html example (which we first met in the Dealing with files article):

<!DOCTYPE html>
    <meta charset="utf-8">
    <title>My test page</title>
    <img src="images/firefox-icon.png" alt="My test image">

Here we have:

  • <!DOCTYPE html> — the doctype. In the mists of time, when HTML was young (about 1991/2), doctypes were meant to act as links to a set of rules that the HTML page had to follow to be considered good HTML, which could mean automatic error checking and other useful things. However, these days no one really cares about them, and they are really just a historical artefact that needs to be included for everything to work right. For now, that's all you need to know.
  • <html></html> — the <html> element. This element wraps all the content on the entire page, and is sometimes known as the root element.
  • <head></head> — the <head> element. This element acts as a container for all the stuff you want to include on the HTML page that isn't the content you are showing to your page's viewers. This includes things like keywords and a page description that you want to appear in search results, CSS to style our content, character set declarations, and more.
  • <body></body> — the <body> element. This contains all the content that you want to show to web users when they visit your page, whether that's text, images, videos, games, playable audio tracks, or whatever else.
  • <meta charset="utf-8"> — this element sets the character set your document should use to UTF-8, which includes most characters from the vast majority of human written languages. Essentially it can now handle any textual content you might put on it. There is no reason not to set this, and it can help avoid some problems later on.
  • <title></title> — the <title> element. This sets the title of your page, which is the title that appears in the browser tab the page is loaded in. It is also used to describe the page when you bookmark/favourite it.


Let's turn our attention to the <img> element again:

<img src="images/firefox-icon.png" alt="My test image">

As we said before, it embeds an image into our page in the position it appears. It does this via the src (source) attribute, which contains the path to our image file.

We have also included an alt (alternative) attribute. In this attribute, you specify descriptive text for users who cannot see the image, possibly because:

  1. They are visually impaired. Users with significant visual impairments often use tools called screen readers to read out the alt text to them.
  2. Something has gone wrong causing the image to not display. For example, try deliberately changing the path inside your src attribute to make it incorrect. If you save and reload the page, you should see something like this in place of the image:

The key words about alt text are "descriptive text". The alt text you write should provide the reader with enough information to have a good idea of what the image conveys. In this example, our current text of "My test image" is no good at all. A much better alternative for our Firefox logo would be "The Firefox logo: a flaming fox surrounding the Earth."

Try coming up with some better alt text for your image now.

Nota: saiba mais sobre a acessibilidade em MDN - Página de Acessibilidade.

Marcação de texto

Esta secção irá abranger alguns dos elementos básicos de HTML que irá utilizar para marcar texto.


Heading elements allow you to specify that certain parts of your content are headings — or subheadings — of your content. In the same way that a book has a main title, chapter titles and subtitles, an HTML document can too. HTML contains six heading levels, <h1><h6> although you'll commonly only use 3–4 at most:

<h1>My main title</h1>
<h2>My top level heading</h2>
<h3>My subheading</h3>
<h4>My sub-subheading</h4>

Now try adding a suitable title to your HTML page just above your <img> element.


As explained above, <p> elements are for containing paragraphs of text; you'll use these frequently when marking up regular text content:

<p>This is a single paragraph</p>

Add your sample text (you should have it from What should your website look like?) into one or a few paragraphs, placed directly below your <img> element.


A lot of the web's content is lists, and HTML has special elements for these. Marking up lists always consist of at least two elements. The most common list types are ordered and unordered lists:

  1. Unordered lists are for lists where the order of the items doesn't matter, like a shopping list. These are wrapped in a <ul> element.
  2. Ordered lists are for lists where the order of the items does matter, like a recipe. These are wrapped in an <ol> element.

Each item inside the lists is put inside an <li> (list item) element.

For example, if we wanted to turn the part of the following paragraph fragment into a list:

<p>At Mozilla, we’re a global community of technologists, thinkers, and builders working together ... </p>

We could modify the markup to this:

<p>At Mozilla, we’re a global community of</p>

<p>working together ... </p>

Try adding an ordered or unordered list to your example page.


Links are very important — they are what makes the web a web! To add a link, we need to use a simple element — <a> — the "a" being short for "anchor". To make text within your paragraph into a link, follow these steps:

  1. Choose some text. We chose the text "Mozilla Manifesto".
  2. Wrap the text in an <a> element, like so:
    <a>Mozilla Manifesto</a>
  3. Give the <a> element an href attribute, like so:
    <a href="">Mozilla Manifesto</a>
  4. Fill in the value of this attribute with the web address that you want the link to link to:
    <a href="">Mozilla Manifesto</a>

You might get unexpected results if you omit the https:// or http:// part, called the protocol, at the beginning of the web address. After making a link, click it to make sure it is sending you where you wanted it to.

href might appear like a rather obscure choice for an attribute name at first. If you are having trouble remembering it, remember that it stands for hypertext reference.

Add a link to your page now, if you haven't already done so.


If you have followed all the instructions in this article, you should end up with a page that looks like the one below (you can also view it here):

A web page screenshot showing a firefox logo, a heading saying mozilla is cool, and two paragraphs of filler text

If you get stuck, you can always compare your work with our finished example code on GitHub.

Here, we have only really scratched the surface of HTML. To find out more, go to our HTML Learning topic.


Neste módulo


Etiquetas do documento e contribuidores

Contribuidores para esta página: mrsilvino, mansil
Última atualização por: mrsilvino,