Textos ricos em Markdown¶
No capítulo anterior aprendemos como criar textos em Markdown. Agora você aprenderá como inserir elementos mais avançados como:
- Equações matemáticas
- Tabelas
- Links
- Imagens
- Lista de tarefas
Equações matemáticas¶
Markdown suporta equações matemáticas usando o MathJax. MathJax é uma biblioteca escrita em JavaScript que permite a escrita de equações nos navegadores e em Markdown.
MathJax¶
Esta biblioteca tem uma sintaxe muito similar ao LaTeX. Esta última é uma linguagem de marcação de texto muito utilizada na produção de textos acadêmicos.
Como é possível ver MathJax não é exatamente LaTeX, mas segue uma sintaxe muito parecida. Sobre as diferenças e limitações, é possível encontrá-las na documentação do MathJax, disponível abaixo:
https://docs.mathjax.org/en/latest/input/tex/differences.html
E ainda, todos os comandos do MathJax também estão disponíveis na documentação:
https://docs.mathjax.org/en/latest/input/tex/macros/index.html
Você pode usá-la para buscar os comandos, se necessário.
¶
Sites úteis¶
Caso não tenha familiaridade com o LaTeX é possível usar alguns sites que pode te ajudar a escrever as equações. São eles:
- MathJax Cheat Sheet
https://jojozhuang.github.io/tutorial/mathjax-cheat-sheet-for-mathematical-notation/
Mostra os comandos básicos para a escrita de equações em LaTeX e MathJax
- Online LaTeX Equation Editor
Site onde é possível escrever equações em LaTeX de forma gráfica.
Equações inline (Em linha)¶
Equações inline são inseridas diretamente no texto. Para isso, use $ ao redor da equação:
A equação de Einstein é $E = mc^2$, onde:
- $E$: energia;
- $m$: massa;
- $c$: velocidade da luz.
Produz:
A equação de Einstein é $E = mc^2$, onde:
- $E$: energia;
- $m$: massa;
- $c$: velocidade da luz.
Tarefa:
Escreva algum texto utilize a notação inline do MathJax. Caso não se recorde, utilize como base o exemplo abaixo:
A fórmula da área de um círculo é dada por $A = \pi r^2$, sendo $A$ a área e $r$ o raio do círculo.
Dica:
Caso não tenha familiaridade com o LaTeX, pode usar os sites indicados anteriormente.
Equações destacadas¶
Equações destacadas são dispostas de forma centralizadas. Para inserí-las utilize $$ para delimitá-las:
markdown A equação quadrática é dada por: $$ x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a} $$
Tarefa:
Escreva de forma destacada a definição de derivada de uma função $f(t)$ usando o conceito de limite. Caso não lembre segue abaixo:
$$
\frac{df}{dt}=\lim_{h\rightarrow}\frac{f(t+h)-f(t)}{h}
$$
Tarefa:
Escreva a lei de Newton de forma destacada e logo abaixo escreva um texto indicando o que significa cada termo usando equações inline.
Tabelas¶
Em Markdown, você pode criar tabelas organizadas facilmente.
- Cabeçalho: Usa-se três ou mais hífens (
---)
| Nome | Idade | Cidade |
|-------|-------|------------|
| Omar | 22 | Puno |
| Lucas | 20 | Salvador |
| Ian | 25 | Rio Branco |
Resultando em:
| Nome | Idade | Cidade |
|---|---|---|
| Omar | 22 | Puno |
| Lucas | 20 | Salvador |
| Ian | 25 | Rio Branco |
As larguras das células podem variar, como mostrado abaixo.
| Nome | Idade | Cidade |
|---|---|---|
| Omar | 22 | Puno |
| Lucas | 20 | Salvador |
| Ian | 25 | Rio Branco |
A saída renderizada terá a mesma aparência:
| Nome | Idade | Cidade |
|---|---|---|
| Omar | 22 | Puno |
| Lucas | 20 | Salvador |
| Ian | 25 | Rio Branco |
Tarefa:
Crie uma tabela que mostra a cor favorita de cada pessoa:
- João - Azul
- Pedro - Verde
- Maria - Rosa
Sites úteis¶
Criar tabelas com hifens e barras verticais pode ser tedioso. Para acelerar o processo, existe um site que permite criar tabelas usando interface gráfica:
Tarefa:
Tente usar o Markdown Tables Generator. Crie uma tabela usando a interface gráfica e, em seguida, copie o texto gerado no formato Markdown para o seu arquivo. Caso não tenha uma tabela em mente pode usar qualquer exemplo anterior.
Alinhamento¶
Você pode alinhar o texto nas colunas à esquerda, à direita ou ao centro adicionando dois pontos ( :) à esquerda, à direita ou em ambos os lados dos hifens dentro da linha de cabeçalho.
| Matícula | Aluno | Nota |
| :------- | :-----: | ---: |
| 123 | Isabele | 9,5 |
| 456 | Pedro | 7,2 |
Dica:
Você pode configurar o alinhamento com o Markdown Tables Generator.
Tarefa:
Refaça a tabela:
- João - Azul
- Pedro - Verde
- Maria - Rosa
Onde os nomes devem está alinhados a esquerda e a cor deve está alinhada a direita.
Formatando textos em tabelas¶
Você pode formatar o texto dentro de tabelas. Por exemplo, você pode adicionar código, link e ênfase.
Tarefa:
Faça uma tabela que mostra o código de sintaxe em Markdown e o resultado.
Links¶
Para criar um link, coloque o texto do link entre colchetes (por exemplo, [Site do Pudim]) e, em seguida, coloque imediatamente o URL entre parênteses (por exemplo, (https://www.pudim.com.br/)).
Acesse o site do [Pudim](https://www.pudim.com.br/).
Resulta em:
Acesse o site do Pudim.
Tarefa:
Escreva uma frase que aponte o link do site do curso. Coloque o nome do curso como "Python para iniciantes".
Imagens¶
Para adicionar imagens basta seguir a notação:
O endereço pode ser um endereço do computador ou um endereço da Web. Abaixo segue um exemplo de uma imagem tirada da internet:
Resulta em:
Também é possível adicionar uma figura copiando e colando no Jupyter.
Tarefa:
Procura uma figura na internet baixe a figura. Salve na mesma pasta do seu notebook e adicione no notebook.
Faça a mesma coisa copiando diretamente o endereço da figura na internet.
Lista de tarefas¶
Lista de tarefas permite você criar uma lista de itens com caixa de seleção.
Para criar uma lista de tarefas, adicione traços (-) e colchetes com um espaço ([ ]) na frente dos itens da lista de tarefas.
Para selecionar uma caixa de seleção, adicione um xentre os colchetes ([x]).
- [x] Estudar Markdown
- [ ] Estudar Python
Resulta em:
- Estudar Markdown
- Estudar Python
Tarefa:
Faça uma lista de afazeres desta semana. Marque os itens que já foram concluidos.