mirror of
https://github.com/adambard/learnxinyminutes-docs.git
synced 2024-12-23 09:41:36 +00:00
[markdown/*] remove table of contents
This commit is contained in:
Boris Verkhovskiy
parent
182242d7c5
commit
962dfca817
@ -19,41 +19,18 @@ které markdown dále zpracovávají) mírně odlišuje. V této příručce se
|
||||
upozorňovat, kdy se jedná o obecnou vlastnost markdownu a kdy se jedná o
|
||||
specifickou vlastnost daného parseru.
|
||||
|
||||
## Obsah
|
||||
|
||||
- [Obsah](#obsah)
|
||||
- [HTML Elementy](#html-elementy)
|
||||
- [Nadpisy](#nadpisy)
|
||||
- [Jednoduché stylování textu](#jednoduché-stylování-textu)
|
||||
- [Odstavce](#odstavce)
|
||||
- [Blokové citace](#blokové-citace)
|
||||
- [Seznamy](#seznamy)
|
||||
- [Bloky kódu](#bloky-kódu)
|
||||
- [Vodorovná čára (`<hr />`)](#vodorovná-čára-hr-)
|
||||
- [Odkazy](#odkazy)
|
||||
- [Obsahy](#obsahy)
|
||||
- [Obrázky](#obrázky)
|
||||
- [Ostatní](#ostatní)
|
||||
- [Automatické odkazy](#automatické-odkazy)
|
||||
- [Automatické odkazy z emailů](#automatické-odkazy-z-emailů)
|
||||
- [Escapování znaků](#escapování-znaků)
|
||||
- [Klávesové zkratky](#klávesové-zkratky)
|
||||
- [Tabulky](#tabulky)
|
||||
- [Markdownlint](#markdownlint)
|
||||
- [Reference](#reference)
|
||||
|
||||
## HTML Elementy
|
||||
|
||||
Markdown je nadstavba HTML. To znamená, že každý HTML kód je zároveň validním
|
||||
kódem v Markdownu.
|
||||
|
||||
```md
|
||||
<!-- To znamená, že v Markdownu můžeme používat HTML elementy jako například
|
||||
komentáře, které nebudou ovlivněny parserem Markdownu. Na druhou stranu to také
|
||||
znamená, že pokud ve svém Markdown kódu vytvoříte HTML element, už v rámci
|
||||
tohoto elementu nelze použít Markdown.
|
||||
<!-- To znamená, že v Markdownu můžeme používat HTML elementy jako například
|
||||
komentáře, které nebudou ovlivněny parserem Markdownu. Na druhou stranu to také
|
||||
znamená, že pokud ve svém Markdown kódu vytvoříte HTML element, už v rámci
|
||||
tohoto elementu nelze použít Markdown.
|
||||
|
||||
Markdown využívá i tato stránka, a tak by tento text, kdyby nebyl obalen v bloku
|
||||
Markdown využívá i tato stránka, a tak by tento text, kdyby nebyl obalen v bloku
|
||||
kódu (viz níže), jako validní HTML komentář vůbec nebyl vidět. -->
|
||||
```
|
||||
|
||||
@ -132,7 +109,7 @@ Blokové citace se dělají jednoduše uvozením řádku znakem >.
|
||||
|
||||
```md
|
||||
> Toto je bloková citace. Můžete dokonce
|
||||
> manuálně rozdělit řádky, a před každý vložit >, nebo nechat vaše řádky
|
||||
> manuálně rozdělit řádky, a před každý vložit >, nebo nechat vaše řádky
|
||||
> jakkoli dlouhé, ať se zarovnají samy.
|
||||
> Je to jedno, pokud vždy začínají symbolem `>`.
|
||||
|
||||
@ -170,7 +147,7 @@ nebo
|
||||
2. Položka dvě
|
||||
3. Položka tři
|
||||
|
||||
<!-- Čísla ani nemusíte psát popořadě. Markdown je umí zobrazit správně, jenom
|
||||
<!-- Čísla ani nemusíte psát popořadě. Markdown je umí zobrazit správně, jenom
|
||||
je třeba vždy překontrolovat, že číslování funguje správně. -->
|
||||
|
||||
1. Položka jedna
|
||||
@ -254,8 +231,8 @@ pomlček), a to buď s mezerami mezi jednotlivými znaky, nebo bez nich.
|
||||
## Odkazy
|
||||
|
||||
```md
|
||||
<!-- Jedna z nejlepších vlastností Markdownu je, jak snadno lze s jeho pomocí
|
||||
vytvářet odkazy. Text odkazu, který chcete zobrazit vložte do [] a hned za něj
|
||||
<!-- Jedna z nejlepších vlastností Markdownu je, jak snadno lze s jeho pomocí
|
||||
vytvářet odkazy. Text odkazu, který chcete zobrazit vložte do [] a hned za něj
|
||||
v kulatých závorkách () připojte url adresu. -->
|
||||
|
||||
[Klikni na mě!](http://test.com/)
|
||||
@ -279,12 +256,12 @@ v kulatých závorkách () připojte url adresu. -->
|
||||
[link1]: http://test.com/ "Cool!"
|
||||
[neco]: http://neco.czz/ "Dobře!"
|
||||
|
||||
<!-- Titulek v tomto případě může být v jednoduchých uvozovkách, závorkách, nebo
|
||||
zcela vynechaný. Reference může být kdekoliv ve vašem dokumentu a identifikátory
|
||||
<!-- Titulek v tomto případě může být v jednoduchých uvozovkách, závorkách, nebo
|
||||
zcela vynechaný. Reference může být kdekoliv ve vašem dokumentu a identifikátory
|
||||
mohou být jakékoli, pokud jsou unikátní. -->
|
||||
|
||||
|
||||
<!-- V markdownu existuje rovněž "implicitní pojmenování", které použije text
|
||||
<!-- V markdownu existuje rovněž "implicitní pojmenování", které použije text
|
||||
odkazu jako své id -->
|
||||
|
||||
[Toto][] je odkaz..
|
||||
@ -331,7 +308,7 @@ fungovat stejně.
|
||||
### Automatické odkazy
|
||||
|
||||
```md
|
||||
<http://stranka.cz/>
|
||||
<http://stranka.cz/>
|
||||
|
||||
je stejné jako
|
||||
|
||||
@ -347,14 +324,14 @@ je stejné jako
|
||||
### Escapování znaků
|
||||
|
||||
```md
|
||||
Chci napsat *tento text obklopený hvězdičkami*, ale protože nechci, aby to bylo
|
||||
Chci napsat *tento text obklopený hvězdičkami*, ale protože nechci, aby to bylo
|
||||
kurzívou, tak hvězdičky vyescapuji `\`: \*tento text bude obklopený hvězdičkami\*.
|
||||
```
|
||||
|
||||
### Klávesové zkratky
|
||||
|
||||
```md
|
||||
<!-- V Markdownu od GitHubu můžete použít tag <kbd> k označení kláves na
|
||||
<!-- V Markdownu od GitHubu můžete použít tag <kbd> k označení kláves na
|
||||
počítači -->
|
||||
|
||||
Váš počítač přestal pracovat? Zkuste
|
||||
|
||||
@ -13,7 +13,6 @@ fácilmente a HTML (y, actualmente, otros formatos también).
|
||||
|
||||
¡Denme toda la retroalimentación que quieran! / ¡Sientanse en la libertad de hacer forks o pull requests!
|
||||
|
||||
|
||||
```md
|
||||
<!-- Markdown está basado en HTML, así que cualquier archivo HTML es Markdown
|
||||
válido, eso significa que podemos usar elementos HTML en Markdown como, por
|
||||
|
||||
@ -6,7 +6,6 @@ filename: markdown-fr.md
|
||||
lang: fr-fr
|
||||
---
|
||||
|
||||
|
||||
Markdown a été créé par John Gruber en 2004. Il se veut être d'une syntaxe
|
||||
facile à lire et à écrire, aisément convertible en HTML (et dans beaucoup
|
||||
d'autres formats aussi).
|
||||
@ -15,17 +14,6 @@ Les implémentations du Markdown varient d'un analyseur syntaxique à un autre.
|
||||
Ce guide va essayer de clarifier quand une fonctionnalité est universelle ou
|
||||
quand elle est specifique à un certain analyseur syntaxique.
|
||||
|
||||
- [Balises HTML](#balises-html)
|
||||
- [En-têtes](#en-tetes)
|
||||
- [Styles de texte basiques](#style-de-text-basiques)
|
||||
- [Paragraphes](#paragraphes)
|
||||
- [Listes](#listes)
|
||||
- [Blocs de code](#blocs-de-code)
|
||||
- [Séparateur horizontal](#separateur-horizontal)
|
||||
- [Liens hypertextes](#liens-hypertextes)
|
||||
- [Images](#images)
|
||||
- [Divers](#divers)
|
||||
|
||||
## Balises HTML
|
||||
|
||||
Markdown est un sur-ensemble du HTML, donc tout fichier HTML est un ficher
|
||||
@ -107,7 +95,7 @@ un ou plusieurs espaces à la fin de votre paragraphe, et en commencer un
|
||||
nouveau.
|
||||
|
||||
```md
|
||||
J'ai deux espaces vides à la fin (sélectionnez moi pour les voir).
|
||||
J'ai deux espaces vides à la fin (sélectionnez moi pour les voir).
|
||||
|
||||
Bigre, il y a un <br /> au dessus de moi!
|
||||
```
|
||||
|
||||
@ -12,7 +12,6 @@ Markdown dibuat oleh John Gruber pada tahun 2004. Tujuannya untuk menjadi syntax
|
||||
|
||||
Beri masukan sebanyak-banyaknya! / Jangan sungkan untuk melakukan fork dan pull request!
|
||||
|
||||
|
||||
```md
|
||||
<!-- Markdown adalah superset dari HTML, jadi setiap berkas HTML adalah markdown yang
|
||||
valid, ini berarti kita dapat menggunakan elemen HTML dalam markdown, seperti elemen
|
||||
|
||||
@ -14,24 +14,13 @@ Markdown è stato creato da John Gruber nel 2004. Il suo scopo è quello di esse
|
||||
|
||||
Markdown varia nelle sue implementazioni da un parser all'altro. Questa guida cercherà di chiarire quali caratteristiche esistono a livello globale o quando sono disponibili solo per un determinato parser.
|
||||
|
||||
- [Elementi HTML](#elementi-html)
|
||||
- [Titoli](#titoli)
|
||||
- [Stili di testo semplici](#stili-di-testo-semplici)
|
||||
- [Paragrafi](#paragrafi)
|
||||
- [Liste](#liste)
|
||||
- [Estratti di codice](#estratti-di-codice)
|
||||
- [Linea orizzontale](#linea-orizzontale)
|
||||
- [Links](#links)
|
||||
- [Immagini](#immagini)
|
||||
- [Miscellanea](#miscellanea)
|
||||
|
||||
## Elementi HTML
|
||||
Markdown è un superset di HTML, quindi ogni file HTML è a sua volta un file Markdown valido.
|
||||
|
||||
```md
|
||||
<!-- Questo significa che possiamo usare elementi di HTML in Markdown, come per esempio i commenti,
|
||||
e questi non saranno modificati dal parser di Markdown. State attenti però,
|
||||
se inserite un elemento HTML nel vostro file Markdown, non potrete usare la sua sintassi
|
||||
e questi non saranno modificati dal parser di Markdown. State attenti però,
|
||||
se inserite un elemento HTML nel vostro file Markdown, non potrete usare la sua sintassi
|
||||
all'interno del contenuto dell'elemento. -->
|
||||
```
|
||||
|
||||
@ -47,6 +36,7 @@ Potete creare gli elementi HTML da `<h1>` a `<h6>` facilmente, basta che inseria
|
||||
##### Questo è un <h5>
|
||||
###### Questo è un <h6>
|
||||
```
|
||||
|
||||
Markdown inoltre fornisce due alternative per indicare gli elementi h1 e h2
|
||||
|
||||
```md
|
||||
@ -77,6 +67,7 @@ In GitHub Flavored Markdown, che è utilizzato per renderizzare i file markdown
|
||||
```md
|
||||
~~Questo testo è barrato.~~
|
||||
```
|
||||
|
||||
## Paragrafi
|
||||
|
||||
```md
|
||||
@ -109,7 +100,6 @@ Le citazioni sono semplici da inserire, basta usare il carattere >.
|
||||
> Potete utilizzare anche più di un livello
|
||||
>> di indentazione!
|
||||
> Quanto è comodo?
|
||||
|
||||
```
|
||||
|
||||
## Liste
|
||||
@ -148,6 +138,7 @@ Non dovete nemmeno mettere i numeri nell'ordine giusto, markdown li visualizzer
|
||||
1. Secondo oggetto
|
||||
1. Terzo oggetto
|
||||
```
|
||||
|
||||
(Questa lista verrà visualizzata esattamente come quella dell'esempio prima)
|
||||
|
||||
Potete inserire anche sotto liste
|
||||
@ -170,6 +161,7 @@ I box senza la 'x' sono checkbox HTML ancora da completare.
|
||||
Il box subito sotto è una checkbox HTML spuntata.
|
||||
- [x] Questo task è stato completato.
|
||||
```
|
||||
|
||||
## Estratti di codice
|
||||
|
||||
Potete inserire un estratto di codice (che utilizza l'elemento `<code>`) indentando una linea con quattro spazi oppure con un carattere tab.
|
||||
@ -206,7 +198,7 @@ end
|
||||
Se usate questa sintassi, il testo non richiederà di essere indentato, inoltre GitHub userà l'evidenziazione della sintassi del linguaggio specificato dopo i \`\`\` iniziali
|
||||
|
||||
## Linea orizzontale
|
||||
Le linee orizzontali (`<hr/>`) sono inserite facilmente usanto tre o più asterischi o trattini, con o senza spazi.
|
||||
Le linee orizzontali (`<hr/>`) sono inserite facilmente usanto tre o più asterischi o trattini, con o senza spazi.
|
||||
|
||||
```md
|
||||
***
|
||||
@ -235,6 +227,7 @@ La sintassi funziona anche con i path relativi.
|
||||
```
|
||||
|
||||
Markdown supporta inoltre anche la possibilità di aggiungere i link facendo riferimento ad altri punti del testo.
|
||||
|
||||
```md
|
||||
[Apri questo link][link1] per più informazioni!
|
||||
[Guarda anche questo link][foobar] se ti va.
|
||||
@ -242,17 +235,21 @@ Markdown supporta inoltre anche la possibilità di aggiungere i link facendo rif
|
||||
[link1]: http://test.com/ "Bello!"
|
||||
[foobar]: http://foobar.biz/ "Va bene!"
|
||||
```
|
||||
|
||||
l titolo può anche essere inserito in apici singoli o in parentesi, oppure omesso interamente. Il riferimento può essere inserito in un punto qualsiasi del vostro documento e l'identificativo del riferimento può essere lungo a piacere a patto che sia univoco.
|
||||
|
||||
Esiste anche un "identificativo implicito" che vi permette di usare il testo del link come id.
|
||||
|
||||
```md
|
||||
[Questo][] è un link.
|
||||
|
||||
[Questo]: http://thisisalink.com/
|
||||
```
|
||||
|
||||
Ma non è comunemente usato.
|
||||
|
||||
## Immagini
|
||||
|
||||
Le immagini sono inserite come i link ma con un punto esclamativo inserito prima delle parentesi quadre!
|
||||
|
||||
```md
|
||||
@ -266,18 +263,21 @@ E la modalità a riferimento funziona esattamente come ci si aspetta
|
||||
|
||||
[myimage]: relative/urls/cool/image.jpg "Se vi serve un titolo, lo mettete qui"
|
||||
```
|
||||
## Miscellanea
|
||||
|
||||
## Miscellanea
|
||||
### Auto link
|
||||
|
||||
```md
|
||||
<http://testwebsite.com/> è equivalente ad
|
||||
[http://testwebsite.com/](http://testwebsite.com/)
|
||||
```
|
||||
|
||||
### Auto link per le email
|
||||
|
||||
```md
|
||||
<foo@bar.com>
|
||||
```
|
||||
|
||||
### Caratteri di escaping
|
||||
|
||||
```md
|
||||
@ -285,6 +285,7 @@ Voglio inserire *questo testo circondato da asterischi* ma non voglio che venga
|
||||
```
|
||||
|
||||
### Combinazioni di tasti
|
||||
|
||||
In GitHub Flavored Markdown, potete utilizzare il tag `<kbd>` per raffigurare i tasti della tastiera.
|
||||
|
||||
```md
|
||||
@ -293,6 +294,7 @@ Il tuo computer è crashato? Prova a premere
|
||||
```
|
||||
|
||||
### Tabelle
|
||||
|
||||
Le tabelle sono disponibili solo in GitHub Flavored Markdown e sono leggeremente complesse, ma se proprio volete inserirle fate come segue:
|
||||
|
||||
```md
|
||||
@ -301,6 +303,7 @@ Le tabelle sono disponibili solo in GitHub Flavored Markdown e sono leggeremente
|
||||
| Allineato a sinistra | Centrato | Allineato a destra |
|
||||
| blah | blah | blah |
|
||||
```
|
||||
|
||||
oppure, per lo stesso risultato
|
||||
|
||||
```md
|
||||
|
||||
@ -12,17 +12,6 @@ lang: ko-kr
|
||||
마크다운은 또한 파서마다 구현이 다양합니다. 본 문서는 어떤 기능이 보편적인지,
|
||||
혹은 어떤 기능이 특정 파서에 종속되어 있는지 명확히 하고자 합니다.
|
||||
|
||||
- [HTML 요소](#html-elements)
|
||||
- [제목](#headings)
|
||||
- [간단한 텍스트 꾸미기](#simple-text-styles)
|
||||
- [문단](#paragraphs)
|
||||
- [목록](#lists)
|
||||
- [코드](#code-blocks)
|
||||
- [수평선](#horizontal-rule)
|
||||
- [링크](#links)
|
||||
- [이미지](#images)
|
||||
- [기타](#miscellany)
|
||||
|
||||
## HTML 요소
|
||||
HTML은 마크다운의 수퍼셋입니다. 모든 HTML 파일은 유효한 마크다운이라는 것입니다.
|
||||
|
||||
@ -90,6 +79,7 @@ __이 텍스트도 같습니다.__
|
||||
|
||||
나는 세 번째 문단!
|
||||
```
|
||||
|
||||
HTML `<br />` 태그를 삽입하고 싶으시다면, 두 개 이상의 띄어쓰기로 문단을 끝내고
|
||||
새 문단을 시작할 수 있습니다.
|
||||
|
||||
|
||||
@ -16,25 +16,6 @@ Markdown also varies in implementation from one parser to a next. This
|
||||
guide will attempt to clarify when features are universal or when they are
|
||||
specific to a certain parser.
|
||||
|
||||
- [HTML Elements](#html-elements)
|
||||
- [Headings](#headings)
|
||||
- [Simple text styles](#simple-text-styles)
|
||||
- [Paragraphs](#paragraphs)
|
||||
- [Lists](#lists)
|
||||
- [Code blocks](#code-blocks)
|
||||
- [Horizontal rule](#horizontal-rule)
|
||||
- [Links](#links)
|
||||
- [Table of contents](#table-of-contents)
|
||||
- [Images](#images)
|
||||
- [Miscellany](#miscellany)
|
||||
- [Auto-links](#auto-links)
|
||||
- [Auto-links for emails](#auto-links-for-emails)
|
||||
- [Escaping characters](#escaping-characters)
|
||||
- [Keyboard keys](#keyboard-keys)
|
||||
- [Tables](#tables)
|
||||
- [Markdownlint](#markdownlint)
|
||||
- [Further reading](#further-reading)
|
||||
|
||||
## HTML Elements
|
||||
|
||||
Markdown is a superset of HTML, so any HTML file is valid Markdown.
|
||||
|
||||
@ -20,27 +20,8 @@ O Markdown varia em termos de implementação de um parser para outro. Esse guia
|
||||
irá tentar deixar explícito quando os recursos são universais ou quando são
|
||||
específicos para um parser em específico.
|
||||
|
||||
- [Elementos HTML](#elementos-html)
|
||||
- [Cabeçalhos](#cabeçalhos)
|
||||
- [Estilos de texto simples](#estilos-de-texto-simples)
|
||||
- [Parágrafos](#parágrafos)
|
||||
- [Listas](#listas)
|
||||
- [Blocos de código](#blocos-de-código)
|
||||
- [Linha Horizontal](#linha-horizontal)
|
||||
- [Links](#links)
|
||||
- [Tabela de conteúdo](#tabela-de-conteúdo)
|
||||
- [Imagens](#imagens)
|
||||
- [Miscelânea](#miscelânea)
|
||||
- [Auto-links](#auto-links)
|
||||
- [Auto-links para e-mails](#auto-links-com-e-mails)
|
||||
- [Escapando caracteres](#escapando-caracteres)
|
||||
- [Teclas do teclado](#teclas-do-teclado)
|
||||
- [Tabelas](#tabelas)
|
||||
- [Markdownlint](#markdownlint)
|
||||
- [Leitura complementar](#leitura-complementar)
|
||||
|
||||
## Elementos HTML
|
||||
O Markdown é um superconjunto do HTML, de modo que qualquer arvquivo HTML é
|
||||
O Markdown é um superconjunto do HTML, de modo que qualquer arvquivo HTML é
|
||||
um arquivo Markdown válido.
|
||||
|
||||
```md
|
||||
@ -98,7 +79,7 @@ GitHub, nós também temos:
|
||||
```
|
||||
|
||||
## Parágrafos
|
||||
Os parágrafos estão em uma ou várias linhas adjacentes de texto separadas por
|
||||
Os parágrafos estão em uma ou várias linhas adjacentes de texto separadas por
|
||||
uma ou múltiplas linhas em branco.
|
||||
|
||||
```md
|
||||
@ -111,11 +92,11 @@ Ainda continuo no parágrafo 2!
|
||||
Eu estou no parágrafo três!
|
||||
```
|
||||
|
||||
Se você quiser inserir uma tag HTML `<br />`, você pode acabar com um parágrafo
|
||||
Se você quiser inserir uma tag HTML `<br />`, você pode acabar com um parágrafo
|
||||
com dois ou mais espaços e, em seguida, começar um novo parágrafo.
|
||||
|
||||
```md
|
||||
Termino com dois espaços (selecione essa linha para vê-los).
|
||||
Termino com dois espaços (selecione essa linha para vê-los).
|
||||
|
||||
Há um <br /> acima de mim!
|
||||
```
|
||||
@ -123,12 +104,12 @@ Há um <br /> acima de mim!
|
||||
Blocos de citações são fáceis e feitos com o caractere >.
|
||||
|
||||
```md
|
||||
> Este é um bloco de citação. Você pode
|
||||
> Este é um bloco de citação. Você pode
|
||||
> Quebrar manualmente suas linhas e colocar um `>` antes de cada linha ou você
|
||||
> pode deixar suas linhas ficarem muito longas e quebrarem por conta própria.
|
||||
> Não faz diferença, desde que elas comecem com um `>`.
|
||||
|
||||
> Você também pode usar mais de um nível
|
||||
> Você também pode usar mais de um nível
|
||||
>> De recuo?
|
||||
> O quão legal é isso?
|
||||
|
||||
@ -187,7 +168,7 @@ Você também pode usar sublistas.
|
||||
4. Item quatro
|
||||
```
|
||||
|
||||
Existem também listas de tarefas. Isso cria checkboxes (caixas de seleção) do
|
||||
Existem também listas de tarefas. Isso cria checkboxes (caixas de seleção) do
|
||||
HTML.
|
||||
|
||||
```md
|
||||
@ -244,7 +225,7 @@ hífens, com ou sem espaços.
|
||||
```md
|
||||
***
|
||||
---
|
||||
- - -
|
||||
- - -
|
||||
****************
|
||||
```
|
||||
|
||||
@ -280,7 +261,7 @@ O Markdown também suporta links para referências no texto.
|
||||
[link2r]: http://foobar.biz/ "Certo!"
|
||||
```
|
||||
|
||||
O título também pode estar entre aspas simples ou entre parênteses, ou omitido
|
||||
O título também pode estar entre aspas simples ou entre parênteses, ou omitido
|
||||
inteiramente. As referências podem estar em qualquer lugar no documento e os
|
||||
IDs de referência podem ser qualquer um, desde que eles sejam únicos.
|
||||
|
||||
@ -320,7 +301,7 @@ As imagens são feitas da mesma forma que os links, mas com um ponto de
|
||||
exclamação na frente!
|
||||
|
||||
```md
|
||||
|
||||
|
||||
```
|
||||
|
||||
E estilo de referência funciona como esperado
|
||||
@ -331,24 +312,24 @@ E estilo de referência funciona como esperado
|
||||
[Minha imagem]: relative/urls/cool/image.jpg "se precisar de um título, está aqui"
|
||||
```
|
||||
|
||||
## Miscelânea
|
||||
## Miscelânea
|
||||
|
||||
### Auto-links
|
||||
### Auto-links
|
||||
|
||||
```md
|
||||
<http://testwebsite.com/> é equivalente a
|
||||
[http://testwebsite.com/](http://testwebsite.com/)
|
||||
<http://testwebsite.com/> é equivalente a
|
||||
[http://testwebsite.com/](http://testwebsite.com/)
|
||||
```
|
||||
|
||||
### Auto-links para e-mails
|
||||
|
||||
```md
|
||||
<foo@bar.com>
|
||||
<foo@bar.com>
|
||||
```
|
||||
|
||||
### Escapando caracteres
|
||||
|
||||
Quero digitar *Este texto entre asteriscos*, mas eu não quero que ele seja
|
||||
Quero digitar *Este texto entre asteriscos*, mas eu não quero que ele seja
|
||||
em itálico, então eu faço o seguinte: \*Este texto entre asteriscos \*.
|
||||
|
||||
### Teclas do teclado
|
||||
@ -361,9 +342,9 @@ Seu computador travou? Tente apertar
|
||||
<kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd>
|
||||
```
|
||||
|
||||
### Tabelas
|
||||
### Tabelas
|
||||
|
||||
Tabelas estão disponíveis apenas no GitHub Flavored Markdown e são ligeiramente
|
||||
Tabelas estão disponíveis apenas no GitHub Flavored Markdown e são ligeiramente
|
||||
complicadas, mas se você realmente quer:
|
||||
|
||||
```md
|
||||
@ -373,7 +354,7 @@ complicadas, mas se você realmente quer:
|
||||
| blah | blah | blah |
|
||||
```
|
||||
|
||||
Ou, para os mesmos resultados
|
||||
Ou, para os mesmos resultados
|
||||
|
||||
```md
|
||||
Col 1 | Col2 | Col3
|
||||
|
||||
@ -21,22 +21,12 @@ lang: ru-ru
|
||||
В этом руководстве будет указано, какие функции универсальны для языка,
|
||||
а какие зависят от конкретного парсера.
|
||||
|
||||
- [HTML-элементы](#html-elements)
|
||||
- [Заголовки](#headings)
|
||||
- [Простейшая стилизация текста](#simple-text-styles)
|
||||
- [Абзацы](#paragraphs)
|
||||
- [Списки](#lists)
|
||||
- [Блоки кода](#code-blocks)
|
||||
- [Горизонтальный разделитель](#horizontal-rule)
|
||||
- [Ссылки](#links)
|
||||
- [Изображения](#images)
|
||||
- [Разное](#miscellany)
|
||||
|
||||
## HTML-элементы
|
||||
|
||||
Markdown является надмножеством HTML, поэтому любой HTML-файл является
|
||||
корректным документом Markdown.
|
||||
|
||||
```md
|
||||
```md
|
||||
<!-- Это позволяет использовать напрямую
|
||||
любые элементы HTML-разметки, такие, например, как этот комментарий.
|
||||
Встроенные в документ HTML-элементы не затрагиваются парсером Markdown
|
||||
@ -108,7 +98,8 @@ __И этот тоже.__
|
||||
О, а вот это уже абзац №3!
|
||||
```
|
||||
|
||||
Для вставки принудительных переносов можно завершить абзац двумя дополнительными пробелами:
|
||||
Для вставки принудительных переносов можно завершить абзац двумя
|
||||
дополнительными пробелами:
|
||||
|
||||
```md
|
||||
Эта строка завершается двумя пробелами (выделите, чтобы увидеть!).
|
||||
@ -131,6 +122,7 @@ __И этот тоже.__
|
||||
```
|
||||
|
||||
## Списки
|
||||
|
||||
Маркированные списки размечаются вставкой в начало каждого элемента
|
||||
одного из символов «*», «+» или «-»:
|
||||
(символ должен быть одним и тем же для всех элементов)
|
||||
@ -265,6 +257,7 @@ end
|
||||
```md
|
||||
[Ссылка!](http://test.com/ "Ссылка на Test.com")
|
||||
```
|
||||
|
||||
Относительные пути тоже возможны:
|
||||
|
||||
```md
|
||||
@ -296,6 +289,7 @@ Markdown также позволяет размечать ссылку в вид
|
||||
Правда, эта возможность не очень распространена.
|
||||
|
||||
## Изображения
|
||||
|
||||
Разметка изображений очень похожа на разметку ссылок.
|
||||
Нужно всего лишь добавить перед ссылкой восклицательный знак!
|
||||
|
||||
@ -312,6 +306,7 @@ Markdown также позволяет размечать ссылку в вид
|
||||
```
|
||||
|
||||
## Разное
|
||||
|
||||
### Автоссылки
|
||||
|
||||
```md
|
||||
@ -334,6 +329,7 @@ Markdown также позволяет размечать ссылку в вид
|
||||
```
|
||||
|
||||
### Клавиши на клавиатуре
|
||||
|
||||
В GitHub Flavored Markdown для представления клавиш на клавиатуре
|
||||
вы можете использовать тег `<kbd>`.
|
||||
|
||||
@ -343,6 +339,7 @@ Markdown также позволяет размечать ссылку в вид
|
||||
```
|
||||
|
||||
### Таблицы
|
||||
|
||||
Таблицы официально поддерживаются только в GitHub Flavored Markdown,
|
||||
да и синтаксис имеют не слишком удобный.
|
||||
Но если очень нужно, размечайте таблицы так:
|
||||
|
||||
@ -9,23 +9,12 @@ filename: markdown-vi.md
|
||||
lang: vi-vn
|
||||
---
|
||||
|
||||
|
||||
Ngôn ngữ Markdown được sáng lập bởi John Gruber vào năm 2004. Nó được tạo ra với mục đích dễ đọc với cú pháp có thể được dễ dàng chuyển đổi qua HTML và các ngôn ngữ khác
|
||||
|
||||
Markdown có sự khác biệt trong cách cài đặt giữa các trình phân tích cú pháp. Hướng dẫn này sẽ đề cập, giải thích tới nếu tính năng có thể được sử dụng chung hay nó chỉ áp dụng cho một trình phân tích riêng biệt.
|
||||
|
||||
- [Phần tử HTML](#html-elements)
|
||||
- [Đầu mục](#headings)
|
||||
- [Định dạng văn bản](#simple-text-styles)
|
||||
- [Đoạn văn](#paragraphs)
|
||||
- [Danh sách](#lists)
|
||||
- [Khối code](#code-blocks)
|
||||
- [Đường kẻ ngang](#horizontal-rule)
|
||||
- [Liên kết](#links)
|
||||
- [Ảnh](#images)
|
||||
- [Khác](#miscellany)
|
||||
|
||||
## Phần tử HTML
|
||||
|
||||
Markdown là tập cha của HTML, vì vậy bất cứ file HTML nào đều là Markdown đúng.
|
||||
|
||||
```md
|
||||
|
||||
@ -15,18 +15,8 @@ Markdown 由 John Gruber 于 2004年创立. 它旨在成为一门容易读写的
|
||||
在不同的解析器中，Markdown 的实现方法有所不同。
|
||||
此教程会指出哪些特征是通用，哪一些只对某一解析器有效。
|
||||
|
||||
- [HTML标签](#HTML标签)
|
||||
- [标题](#标题)
|
||||
- [文本样式](#文本样式)
|
||||
- [段落](#段落)
|
||||
- [列表](#列表)
|
||||
- [代码块](#代码块)
|
||||
- [水平线分隔](#水平线分隔)
|
||||
- [链接](#链接)
|
||||
- [图片](#图片)
|
||||
- [杂项](#杂项)
|
||||
|
||||
## HTML标签
|
||||
|
||||
Markdown 是 HTML 的父集，所以任何 HTML 文件都是有效的 Markdown。
|
||||
|
||||
```md
|
||||
@ -49,6 +39,7 @@ Markdown 是 HTML 的父集，所以任何 HTML 文件都是有效的 Markdown
|
||||
```
|
||||
|
||||
实际效果（最终显示时会因设置而看起来不同）：
|
||||
|
||||
# 这是一个
|
||||
## 这也是一个
|
||||
### 这还是一个
|
||||
@ -56,7 +47,6 @@ Markdown 是 HTML 的父集，所以任何 HTML 文件都是有效的 Markdown
|
||||
##### 这真的是一个
|
||||
###### 这...是一个
|
||||
|
||||
|
||||
对于 `<h1>` 和 `<h2>` 元素，Markdown 额外提供了两种添加方式。
|
||||
|
||||
```md
|
||||
@ -88,6 +78,7 @@ GitHub 也支持 Markdown，在 GitHub 的 Markdown 解析器中，我们可以
|
||||
```md
|
||||
~~此文本为删除线效果。~~
|
||||
```
|
||||
|
||||
## 段落
|
||||
|
||||
段落由一个句子或是多个中间没有空行的句子组成，每个段落由一个或是多个空行分隔开来。
|
||||
@ -129,6 +120,7 @@ GitHub 也支持 Markdown，在 GitHub 的 Markdown 解析器中，我们可以
|
||||
```
|
||||
|
||||
## 列表
|
||||
|
||||
- 无序列表可由星号，加号或者减号来创建
|
||||
|
||||
```md
|
||||
@ -142,7 +134,7 @@ GitHub 也支持 Markdown，在 GitHub 的 Markdown 解析器中，我们可以
|
||||
+ 项目
|
||||
+ 另一个项目
|
||||
|
||||
或者
|
||||
或者
|
||||
|
||||
- 项目
|
||||
- 项目
|
||||
@ -165,6 +157,7 @@ GitHub 也支持 Markdown，在 GitHub 的 Markdown 解析器中，我们可以
|
||||
1. 项目二
|
||||
1. 项目三
|
||||
```
|
||||
|
||||
(此段与上面效果一模一样)
|
||||
|
||||
你也可以使用子列表
|
||||
@ -197,7 +190,7 @@ GitHub 也支持 Markdown，在 GitHub 的 Markdown 解析器中，我们可以
|
||||
|
||||
```md
|
||||
This is code
|
||||
So is this
|
||||
So is this
|
||||
```
|
||||
|
||||
在你的代码中，你仍然使用tab（或者四个空格）可以进行缩进操作
|
||||
@ -233,11 +226,12 @@ end
|
||||
```md
|
||||
***
|
||||
---
|
||||
- - -
|
||||
- - -
|
||||
****************
|
||||
|
||||
下面这个就是示例
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 链接
|
||||
@ -254,7 +248,8 @@ Markdown 最棒的地方就是便捷的书写链接。把链接文字放在中
|
||||
```md
|
||||
[点我点我!](http://test.com/ "连接到Test.com")
|
||||
```
|
||||
相对路径也可以有
|
||||
|
||||
相对路径也可以有
|
||||
|
||||
```md
|
||||
[去 music](/music/).
|
||||
@ -281,6 +276,7 @@ Markdown同样支持引用形式的链接
|
||||
但这并不常用
|
||||
|
||||
## 图片
|
||||
|
||||
图片与链接相似，只需在前添加一个感叹号
|
||||
|
||||
```md
|
||||
@ -314,6 +310,7 @@ Markdown同样支持引用形式的链接
|
||||
我希望 *将这段文字置于星号之间* 但是我不希望它被
|
||||
斜体化, 这么做: \*这段置文字于星号之间\*。
|
||||
```
|
||||
|
||||
对比一下：*将这段文字置于星号之间* 和 \*将这段文字置于星号之间\*
|
||||
|
||||
### 键盘上的功能键
|
||||
@ -324,6 +321,7 @@ Markdown同样支持引用形式的链接
|
||||
你的电脑死机了？试试
|
||||
<kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd>
|
||||
```
|
||||
|
||||
<kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd>
|
||||
|
||||
（译注：可能由于网站本身样式问题，效果不明显）
|
||||
@ -356,5 +354,4 @@ Markdown同样支持引用形式的链接
|
||||
|
||||
真的是*看着令人头晕*
|
||||
|
||||
|
||||
更多信息, 请于[此处](http://daringfireball.net/projects/Markdown/syntax)参见 John Gruber 关于语法的官方帖子，及于[此处](https://github.com/adam-p/Markdown-here/wiki/Markdown-Cheatsheet) 参见 Adam Pritchard 的摘要笔记。
|
||||
|
||||
Loading…
Reference in New Issue
Block a user