mirror of
https://github.com/adambard/learnxinyminutes-docs.git
synced 2024-12-23 17:41:41 +00:00
[markdown/*] remove table of contents
This commit is contained in:
Boris Verkhovskiy
parent
182242d7c5
commit
962dfca817
@ -19,29 +19,6 @@ 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
|
||||
|
||||
@ -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
|
||||
|
||||
@ -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,17 +14,6 @@ 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.
|
||||
|
||||
@ -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.
|
||||
@ -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,6 +263,7 @@ 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
|
||||
### Auto link
|
||||
|
||||
@ -273,11 +271,13 @@ E la modalità a riferimento funziona esattamente come ci si aspetta
|
||||
<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,25 +20,6 @@ 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 é
|
||||
um arquivo Markdown válido.
|
||||
|
||||
@ -21,18 +21,8 @@ lang: ru-ru
|
||||
В этом руководстве будет указано, какие функции универсальны для языка,
|
||||
а какие зависят от конкретного парсера.
|
||||
|
||||
- [HTML-элементы](#html-elements)
|
||||
- [Заголовки](#headings)
|
||||
- [Простейшая стилизация текста](#simple-text-styles)
|
||||
- [Абзацы](#paragraphs)
|
||||
- [Списки](#lists)
|
||||
- [Блоки кода](#code-blocks)
|
||||
- [Горизонтальный разделитель](#horizontal-rule)
|
||||
- [Ссылки](#links)
|
||||
- [Изображения](#images)
|
||||
- [Разное](#miscellany)
|
||||
|
||||
## HTML-элементы
|
||||
|
||||
Markdown является надмножеством 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
|
||||
@ -165,6 +157,7 @@ GitHub 也支持 Markdown，在 GitHub 的 Markdown 解析器中，我们可以
|
||||
1. 项目二
|
||||
1. 项目三
|
||||
```
|
||||
|
||||
(此段与上面效果一模一样)
|
||||
|
||||
你也可以使用子列表
|
||||
@ -238,6 +231,7 @@ end
|
||||
|
||||
下面这个就是示例
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 链接
|
||||
@ -254,6 +248,7 @@ Markdown 最棒的地方就是便捷的书写链接。把链接文字放在中
|
||||
```md
|
||||
[点我点我!](http://test.com/ "连接到Test.com")
|
||||
```
|
||||
|
||||
相对路径也可以有
|
||||
|
||||
```md
|
||||
@ -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