Tutorial de Markdown no Jupyter Notebook

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.

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.

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.

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:

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

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.

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.

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.

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.

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".

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 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.

Link interno e externo

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.

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.

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.

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.

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.

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.