Pular para o conteúdo principal
InicioTutoriaisDataLab

Tutorial de Markdown no Jupyter Notebook

Neste tutorial, você aprenderá a usar e escrever com diferentes tags de marcação usando o Jupyter Notebook.
abr. de 2024  · 9 min leer

Markdown é uma linguagem de marcação leve e popular que é um padrão de escrita para cientistas e analistas de dados. Geralmente, ele é convertido no HTML correspondente pelo processador Markdown, o que permite que ele seja facilmente compartilhado entre diferentes dispositivos e pessoas.

A linguagem de marcação é semelhante à linguagem de marcação de hipertexto (HTML), composta de tags de marcação, e consiste na tag de abertura <tagname> e na tag de fechamento </tagname>.

Neste tutorial, você pode ver o mesmo resultado obtido com o uso de tags de marcação e também com a sintaxe Markdown, que é compatível com o Jupyter Notebook.

Você precisa ter o Jupyter Notebook, o ambiente pode ser configurado usando o tutorial do DataCamp: Tutorial do Jupyter Notebook: O Guia Definitivo.

As células Markdown podem ser selecionadas no Jupyter Notebook usando o menu suspenso ou também pelo atalho de teclado "m/M" imediatamente após a inserção de uma nova célula.

célula de remarcação para baixo

Comece a aprender Python de graça

Writing Functions in Python

BeginnerSkill Level
4 hr
82.8K learners
Learn to use best practices to write maintainable, reusable, complex functions with good documentation.

Run and edit the code from this tutorial online

Run Code

Títulos

Os títulos começam com '#', ou seja, o símbolo de hash seguido de um espaço, e há seis títulos, sendo que o título maior usa apenas um símbolo de hash e os títulos menores usam seis símbolos de hash.

# (Cabeçalho 1, título)

## (Cabeçalho 2, títulos principais)

### (Cabeçalho 3, subtítulos)

#### (Cabeçalho 4)

##### (Cabeçalho 5)

###### (Cabeçalho 6) ``

Como alternativa, os cabeçalhos podem começar com tags de marcação, ou seja, de h1 a h6, com as seguintes sintaxes.

<h1>Header 1,title<h1>
<h2>Header 2,major headings<h2>
<h3>Header 3,subheadings<h3>
<h4>Header 4<h4>
<h5>Header 5<h5>
<h6>Header 6<h6>

Ambas as sintaxes acima podem renderizar os cabeçalhos de h1 a h6 depois de clicar em "Executar" na barra de ferramentas.

Títulos

Citações em bloco

As citações em bloco podem conter uma grande parte do texto e geralmente são recuadas. Eles podem ser obtidos usando o símbolo '>' do Markdown ou com <blockquote>text for blockquote</blockquote>

  • >Isso é bom
  • <blockquote>Isso é bom</blockquote>

Ambas as sintaxes acima podem renderizar o texto em formato recuado depois de clicar em "Executar" na barra de ferramentas.

Citações em bloco

Seção do código

A seção Code (Código) é a parte que especifica o código de diferentes linguagens de programação e pode ser renderizada onde o código inline começa com ' `inline code goes here` ' traços ao redor dele, mas o bloco de código começa com três traços ' ``` block line code goes here ``` '. Além disso, a tag de marcação para uma seção de código é ' <code>code goes here<code> '.

O exemplo de código em linha é dado abaixo:
`x =5`

Você pode ver que, após clicar em "Run", o código em linha é renderizado com destaque do código.

Seção do código

Exemplos de seções de código são fornecidos abaixo:

    • Usando Markdown
    • ```Python
      str = "Este é um código de nível de bloco"
      print(str)
      ```
    • Uso de tags de marcação
    • <code>Python
      str = "Este é um código de nível de bloco"
      print(str)
    </code>

Usando o Markdown, você pode obter o realce da sintaxe do código se o nome da linguagem de programação for mencionado após os três ticks '```', e o exemplo é dado abaixo:

Seção do código

Usando o Markdown, você não terá destaque de sintaxe, mas o código é destacado:

Seção do código

Símbolo matemático

O símbolo matemático no Markdown está incluído em '\$ mathematical expression goes here \$' (expressão matemática vai aqui \$) entre um símbolo de dólar e, no Markup, você pode seguir este link para obter mais detalhes: Operadores matemáticos. Você pode ver o exemplo de uso dos símbolos matemáticos abaixo.

\$\sqrt{k}$

O exemplo acima renderizará a expressão matemática em um formato em negrito.

Símbolo matemático

Quebra de linha

A tag de quebra de linha começa com a tag <br> sem nenhuma tag de fechamento que quebra a linha, e o conteúdo restante começa com uma nova linha, conforme o exemplo mostrado abaixo.

The line breaks after using <br> br tags and it is awesome.

Depois de clicar em "Executar" na barra de ferramentas, você poderá ver a quebra de linha depois de usar a tag <br>. O texto restante começa em uma nova linha.

Quebra de linha

Texto em negrito e itálico

Você pode usar as tags <b>, '**', ou seja, 'asterisco duplo' ou '__', ou seja, 'sublinhado duplo' para obter texto em negrito com a seguinte sintaxe.

  • <b>Este é um texto em negrito</b>
  • ** Este é um texto em negrito
  • __ Este é um texto em negrito

Todas as sintaxes acima podem renderizar texto em negrito depois de clicar em "Executar" na barra de ferramentas.

Texto em negrito e itálico

Você pode usar as tags <i>, '*', ou seja, asterisco simples, ou '_', ou seja, sublinhado simples, para obter o texto em itálico na sintaxe a seguir.

    • <i>Este é um texto em itálico </i>
    • * Este é um texto em itálico
    • _ Este é um texto em itálico

Todas as sintaxes acima podem renderizar o texto em itálico depois de clicar em "Executar" na barra de ferramentas.

Texto em negrito e itálico

Horizontal Line

Você pode obter uma linha horizontal usando Markdown '---' três hífens ou tags de marcação <hr>

Ambas as sintaxes acima renderizarão a linha horizontal de uma extremidade a outra após clicar em "Run".

Linha horizontal

Lista ordenada

A Lista ordenada é a lista numerada obtida ao iniciar a tag <ol> e terminar com a tag </ol> com o item necessário entre as tags <li> e </li>. A tag, ou seja, "ol", é a forma abreviada de uma lista ordenada e "li" é a forma abreviada do item da lista. Por exemplo, você pode ver a Lista ordenada abaixo contendo o item para a lista de compras.

<ol>
<li>Fish</li>
<li>Eggs</li>
<li>Cheese</li>
</ol>

Como alternativa, você pode listar por '1', ou seja, o número necessário seguido de espaço, conforme o exemplo abaixo.

  1. Peixes
  2. Ovos
  3. Queijo

Ambas as sintaxes acima podem renderizar a lista numerada depois de clicar em "Executar" na barra de ferramentas.

Lista ordenada

Lista não ordenada

A lista não ordenada é uma lista de marcadores que é obtida usando a tag <ul> e terminando com a tag </ul>, veja o exemplo abaixo:

<ul>
<li>Peixe</li>
<li>Ovos</li>
<li>Queijo</li>
</ul>

Como alternativa, a lista não ordenada pode começar com o símbolo '-' com espaço, o que dá o símbolo de círculo preto, e também pode começar com o símbolo '*' com espaço, o que dá o símbolo de quadrado preto.

- Peixes
- Ovos
- Queijo

O exemplo acima mostra que a lista de marcadores contém o símbolo '-' seguido de um espaço com os itens que dão origem ao símbolo de círculo preto.

Ambas as sintaxes acima podem gerar o mesmo resultado a seguir, em que os itens da lista aparecem no círculo preto, depois de clicar em "Run" (Executar) na barra de ferramentas.

Lista não ordenada

O link interno em Markdown começa com a tag <a> com um ID exclusivo definido pelo atributo 'id', que pode ser vinculado no bloco de notas com o exemplo abaixo:

<a id = "division_ID"text goes here></a>

Além disso, o ID definido acima pode ser vinculado à seção do notebook seguindo o código que torna o link clicável.

[Título da seção](#division_ID)

O exemplo acima pode ser visto abaixo, onde o ID definido é vinculado à seção e ao link clicável obtido após clicar em "Run" (Executar) na barra de ferramentas.

Link interno e externo

O link externo em Markdown começa com <a> e termina com a tag <a>, ou seja, <a> representa a âncora que define o link e tem o atributo 'href', também chamado de hiper-referência, que contém o endereço de destino do link ou URL, e os textos entre as tags são visíveis e podem ser clicados para abrir o endereço de destino, conforme mostrado abaixo.

<a> href="https://www.google.com">Link para o Google</a>

Como alternativa, ele também poderia começar com __[link de texto](URL do site)__, em que o sublinhado duplo está em ambos os lados, com o link de texto entre colchetes e o URL do site entre parênteses, seguido pelo URL.

Link para o Google

Ambas as sintaxes acima podem gerar o mesmo resultado abaixo, em que o texto clicável e sublinhado pode levar a uma nova página depois de clicar em "Executar" na barra de ferramentas.

Link interno e externo

Tabela

A tabela contém as informações em linhas e colunas e é criada pela combinação de '|', ou seja, 'tubo vertical' para separar cada coluna e '-', ou seja, o símbolo de hífen para criar o cabeçalho onde a linha em branco, ou seja, uma combinação de tubo vertical e traços para renderizar o formato da tabela.

Além disso, você pode variar as células alinhando-as aproximadamente com as colunas, e o bloco de notas redimensionará automaticamente o conteúdo da célula em questão.

|Name|Address|Salary| |-----|-------|------| |Hanna|Brisbane|4000| |Adam|Sydney|5000|

Como alternativa, o Markdown pode ser usado para criar tabelas em que <tabela> é usado para definir uma tabela com sua largura em porcentagens. <tr> define a linha da tabela que fornece o texto em negrito e centralizado, juntamente com o título da tabela descrito por <th> na parte superior da tabela, e as outras entradas na tabela são definidas pela tag <td>, ou seja, dados da tabela.

<table style="width:20%">
<tr>
<th><Name></th>
<th><Address></th>
<th><Salary></th>
</tr>

<tr>
<td><Hanna></td>
<td><Brisbane></td>
<td><4000></td>
</tr>

<tr>
<td><Adam></td>
<td><Sydney></td>
<td><5000></td>
</tr>
</table>

Ambas as sintaxes acima podem gerar o mesmo resultado após clicar em "Run" (Executar) na barra de ferramentas.

Tabela

Imagens

Você pode inserir uma imagem na barra de ferramentas escolhendo "Insert Image" (Inserir imagem) no menu Edit (Editar) e pode procurar a imagem desejada, conforme mostrado abaixo.

Imagens

Imagens

A imagem pode conter a tag Markdown <img> com a fonte, ou seja, src como um atributo que consiste no link para a imagem com propriedades opcionais, como largura e altura, e o exemplo está abaixo.

<img> <src="https://i.imgur.com/WWrydEh.png" width ="500" height=500 >

Ambos os processos acima podem renderizar a mesma imagem depois de clicar em "Executar" na barra de ferramentas.

imagem

Conclusão

Neste tutorial, você aprendeu sobre diferentes tags de marcação, que são definidas pela linguagem de marcação, e também sobre a sintaxe relacionada às células Markdown específicas do Jupyter Notebook, que são usadas lado a lado com o código para descrever o conteúdo de forma mais eficaz.

Se quiser saber mais sobre Markdown, dê uma olhada no Markdown Guide.

Temas

Cursos de Python

Course

Introduction to Python

4 hr
5.5M
Master the basics of data analysis with Python in just four hours. This online course will introduce the Python interface and explore popular packages.
See DetailsRight Arrow
Start Course
Veja MaisRight Arrow
Relacionado

blog

Jupyter e R Markdown: Notebooks com R

Saiba como instalar, executar e usar o R com o Jupyter Notebook e o R Notebook do RStudio, incluindo dicas e alternativas

Karlijn Willems

20 min

tutorial

Tutorial de introdução ao JupyterLab

Neste artigo, apresentaremos a você o JupyterLab, um dos IDEs mais populares para ciência de dados.
Javier Canales Luna's photo

Javier Canales Luna

7 min

tutorial

Como usar o Jupyter Notebooks: O guia definitivo

Este artigo aborda o que são os notebooks e por que você deve usá-los. Também nos aprofundamos nos notebooks hospedados, que facilitam o compartilhamento e a colaboração. Este artigo também aborda dicas, truques e atalhos de teclado.
Adam Shafi's photo

Adam Shafi

25 min

tutorial

Função do sublinhado (_) no tutorial de Python

Neste tutorial, você aprenderá sobre os usos do sublinhado (_) em python.
Hafeezul Kareem Shaik's photo

Hafeezul Kareem Shaik

8 min

tutorial

Tutorial do GitHub e do Git para iniciantes

Um tutorial para iniciantes que demonstra como funciona o controle de versão do Git e por que ele é crucial para projetos de ciência de dados.
Abid Ali Awan's photo

Abid Ali Awan

17 min

tutorial

Tutorial de junção de DataFrames no pandas

Neste tutorial, você aprenderá várias maneiras pelas quais vários DataFrames podem ser mesclados em python usando a biblioteca Pandas.
DataCamp Team's photo

DataCamp Team

19 min

See MoreSee More