mirror of
https://github.com/adambard/learnxinyminutes-docs.git
synced 2024-12-23 09:41:36 +00:00
md
This commit is contained in:
Adam Bard
parent
5359298b0d
commit
573b2f673c
@ -39,7 +39,7 @@ all'interno del contenuto dell'elemento. -->
|
||||
|
||||
Potete creare gli elementi HTML da `<h1>` a `<h6>` facilmente, basta che inseriate un egual numero di caratteri cancelletto (#) prima del testo che volete all'interno dell'elemento
|
||||
|
||||
```markdown
|
||||
```md
|
||||
# Questo è un <h1>
|
||||
## Questo è un <h2>
|
||||
### Questo è un <h3>
|
||||
@ -49,7 +49,7 @@ Potete creare gli elementi HTML da `<h1>` a `<h6>` facilmente, basta che inseria
|
||||
```
|
||||
Markdown inoltre fornisce due alternative per indicare gli elementi h1 e h2
|
||||
|
||||
```markdown
|
||||
```md
|
||||
Questo è un h1
|
||||
==============
|
||||
|
||||
@ -60,7 +60,7 @@ Questo è un h2
|
||||
## Stili di testo semplici
|
||||
Il testo può essere stilizzato in corsivo o grassetto usando markdown
|
||||
|
||||
```markdown
|
||||
```md
|
||||
*Questo testo è in corsivo.*
|
||||
_Come pure questo._
|
||||
|
||||
@ -74,12 +74,12 @@ __Come pure questo.__
|
||||
|
||||
In Github Flavored Markdown, che è utilizzato per renderizzare i file markdown su Github, è presente anche lo stile barrato:
|
||||
|
||||
```markdown
|
||||
```md
|
||||
~~Questo testo è barrato.~~
|
||||
```
|
||||
## Paragrafi
|
||||
|
||||
```markdown
|
||||
```md
|
||||
I paragrafi sono una o più linee di testo adiacenti separate da una o più righe vuote.
|
||||
|
||||
Questo è un paragrafo. Sto scrivendo in un paragrafo, non è divertente?
|
||||
@ -93,7 +93,7 @@ Qui siamo nel paragrafo 3!
|
||||
|
||||
Se volete inserire l'elemento HTML `<br />`, potete terminare la linea con due o più spazi e poi iniziare un nuovo paragrafo.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
Questa frase finisce con due spazi (evidenziatemi per vederli).
|
||||
|
||||
C'è un <br /> sopra di me!
|
||||
@ -101,7 +101,7 @@ C'è un <br /> sopra di me!
|
||||
|
||||
Le citazioni sono semplici da inserire, basta usare il carattere >.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
> Questa è una citazione. Potete
|
||||
> mandare a capo manualmente le linee e inserire un `>` prima di ognuna, oppure potete usare una sola linea e lasciare che vada a capo automaticamente.
|
||||
> Non c'è alcuna differenza, basta che iniziate ogni riga con `>`.
|
||||
@ -115,7 +115,7 @@ Le citazioni sono semplici da inserire, basta usare il carattere >.
|
||||
## Liste
|
||||
Le liste non ordinate possono essere inserite usando gli asterischi, il simbolo più o dei trattini
|
||||
|
||||
```markdown
|
||||
```md
|
||||
* Oggetto
|
||||
* Oggetto
|
||||
* Altro oggetto
|
||||
@ -135,7 +135,7 @@ oppure
|
||||
|
||||
Le liste ordinate invece, sono inserite con un numero seguito da un punto.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
1. Primo oggetto
|
||||
2. Secondo oggetto
|
||||
3. Terzo oggetto
|
||||
@ -143,7 +143,7 @@ Le liste ordinate invece, sono inserite con un numero seguito da un punto.
|
||||
|
||||
Non dovete nemmeno mettere i numeri nell'ordine giusto, markdown li visualizzerà comunque nell'ordine corretto, anche se potrebbe non essere una buona idea.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
1. Primo oggetto
|
||||
1. Secondo oggetto
|
||||
1. Terzo oggetto
|
||||
@ -152,7 +152,7 @@ Non dovete nemmeno mettere i numeri nell'ordine giusto, markdown li visualizzer
|
||||
|
||||
Potete inserire anche sotto liste
|
||||
|
||||
```markdown
|
||||
```md
|
||||
1. Primo oggetto
|
||||
2. Secondo oggetto
|
||||
3. Terzo oggetto
|
||||
@ -163,7 +163,7 @@ Potete inserire anche sotto liste
|
||||
|
||||
Sono presenti anche le task list. In questo modo è possibile creare checkbox in HTML.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
I box senza la 'x' sono checkbox HTML ancora da completare.
|
||||
- [ ] Primo task da completare.
|
||||
- [ ] Secondo task che deve essere completato.
|
||||
@ -174,14 +174,14 @@ Il box subito sotto è una checkbox HTML spuntata.
|
||||
|
||||
Potete inserire un estratto di codice (che utilizza l'elemento `<code>`) indentando una linea con quattro spazi oppure con un carattere tab.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
Questa è una linea di codice
|
||||
Come questa
|
||||
```
|
||||
|
||||
Potete inoltre inserire un altro tab (o altri quattro spazi) per indentare il vostro codice
|
||||
|
||||
```markdown
|
||||
```md
|
||||
my_array.each do |item|
|
||||
puts item
|
||||
end
|
||||
@ -189,7 +189,7 @@ Potete inoltre inserire un altro tab (o altri quattro spazi) per indentare il vo
|
||||
|
||||
Codice inline può essere inserito usando il carattere backtick `
|
||||
|
||||
```markdown
|
||||
```md
|
||||
Giovanni non sapeva neppure a cosa servisse la funzione `go_to()`!
|
||||
```
|
||||
|
||||
@ -205,7 +205,7 @@ Se usate questa sintassi, il testo non richiederà di essere indentato, inoltre
|
||||
## Linea orizzontale
|
||||
Le linee orizzontali (`<hr/>`) sono inserite facilmente usanto tre o più asterischi o trattini, con o senza spazi.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
***
|
||||
---
|
||||
- - -
|
||||
@ -215,24 +215,24 @@ Le linee orizzontali (`<hr/>`) sono inserite facilmente usanto tre o più asteri
|
||||
## Links
|
||||
Una delle funzionalità migliori di markdown è la facilità con cui si possono inserire i link. Mettete il testo da visualizzare fra parentesi quadre [] seguite dall'url messo fra parentesi tonde ()
|
||||
|
||||
```markdown
|
||||
```md
|
||||
[Cliccami!](http://test.com/)
|
||||
```
|
||||
|
||||
Potete inoltre aggiungere al link un titolo mettendolo fra doppi apici dopo il link
|
||||
|
||||
```markdown
|
||||
```md
|
||||
[Cliccami!](http://test.com/ "Link a Test.com")
|
||||
```
|
||||
|
||||
La sintassi funziona anche con i path relativi.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
[Vai a musica](/music/).
|
||||
```
|
||||
|
||||
Markdown supporta inoltre anche la possibilità di aggiungere i link facendo riferimento ad altri punti del testo.
|
||||
```markdown
|
||||
```md
|
||||
[Apri questo link][link1] per più informazioni!
|
||||
[Guarda anche questo link][foobar] se ti va.
|
||||
|
||||
@ -242,7 +242,7 @@ Markdown supporta inoltre anche la possibilità di aggiungere i link facendo rif
|
||||
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.
|
||||
```markdown
|
||||
```md
|
||||
[Questo][] è un link.
|
||||
|
||||
[Questo]: http://thisisalink.com/
|
||||
@ -252,13 +252,13 @@ Ma non è comunemente usato.
|
||||
## Immagini
|
||||
Le immagini sono inserite come i link ma con un punto esclamativo inserito prima delle parentesi quadre!
|
||||
|
||||
```markdown
|
||||
```md
|
||||
|
||||
```
|
||||
|
||||
E la modalità a riferimento funziona esattamente come ci si aspetta
|
||||
|
||||
```markdown
|
||||
```md
|
||||
![Questo è il testo alternativo.][myimage]
|
||||
|
||||
[myimage]: relative/urls/cool/image.jpg "Se vi serve un titolo, lo mettete qui"
|
||||
@ -266,25 +266,25 @@ E la modalità a riferimento funziona esattamente come ci si aspetta
|
||||
## Miscellanea
|
||||
### Auto link
|
||||
|
||||
```markdown
|
||||
```md
|
||||
<http://testwebsite.com/> è equivalente ad
|
||||
[http://testwebsite.com/](http://testwebsite.com/)
|
||||
```
|
||||
### Auto link per le email
|
||||
|
||||
```markdown
|
||||
```md
|
||||
<foo@bar.com>
|
||||
```
|
||||
### Caratteri di escaping
|
||||
|
||||
```markdown
|
||||
```md
|
||||
Voglio inserire *questo testo circondato da asterischi* ma non voglio che venga renderizzato in corsivo, quindi lo inserirò così: \*questo testo è circondato da asterischi\*.
|
||||
```
|
||||
|
||||
### Combinazioni di tasti
|
||||
In Github Flavored Markdown, potete utilizzare il tag `<kbd>` per raffigurare i tasti della tastiera.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
Il tuo computer è crashato? Prova a premere
|
||||
<kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Canc</kbd>
|
||||
```
|
||||
@ -292,7 +292,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:
|
||||
|
||||
```markdown
|
||||
```md
|
||||
| Col1 | Col2 | Col3 |
|
||||
| :------------------- | :------: | -----------------: |
|
||||
| Allineato a sinistra | Centrato | Allineato a destra |
|
||||
@ -300,7 +300,7 @@ Le tabelle sono disponibili solo in Github Flavored Markdown e sono leggeremente
|
||||
```
|
||||
oppure, per lo stesso risultato
|
||||
|
||||
```markdown
|
||||
```md
|
||||
Col 1 | Col2 | Col3
|
||||
:-- | :-: | --:
|
||||
È una cosa orrenda | fatela | finire in fretta
|
||||
|
||||
@ -34,7 +34,7 @@ HTML은 마크다운의 수퍼셋입니다. 모든 HTML 파일은 유효한 마
|
||||
|
||||
텍스트 앞에 붙이는 우물 정 기호(#)의 갯수에 따라 `<h1>`부터 `<h6>`까지의 HTML 요소를
|
||||
손쉽게 작성할 수 있습니다.
|
||||
```markdown
|
||||
```md
|
||||
# <h1>입니다.
|
||||
## <h2>입니다.
|
||||
### <h3>입니다.
|
||||
@ -43,7 +43,7 @@ HTML은 마크다운의 수퍼셋입니다. 모든 HTML 파일은 유효한 마
|
||||
###### <h6>입니다.
|
||||
```
|
||||
또한 h1과 h2를 나타내는 다른 방법이 있습니다.
|
||||
```markdown
|
||||
```md
|
||||
h1입니다.
|
||||
=============
|
||||
|
||||
@ -53,7 +53,7 @@ h2입니다.
|
||||
## 간단한 텍스트 꾸미기
|
||||
|
||||
마크다운으로 쉽게 텍스트를 기울이거나 굵게 할 수 있습니다.
|
||||
```markdown
|
||||
```md
|
||||
*기울인 텍스트입니다.*
|
||||
_이 텍스트도 같습니다._
|
||||
|
||||
@ -65,14 +65,14 @@ __이 텍스트도 같습니다.__
|
||||
*__이것도 같습니다.__*
|
||||
```
|
||||
깃헙 전용 마크다운에는 취소선도 있습니다.
|
||||
```markdown
|
||||
```md
|
||||
~~이 텍스트에는 취소선이 그려집니다.~~
|
||||
```
|
||||
## 문단
|
||||
|
||||
문단은 하나 이상의 빈 줄로 구분되는, 한 줄 이상의 인접한 텍스트입니다.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
문단입니다. 문단에 글을 쓰다니 재밌지 않나요?
|
||||
|
||||
이제 두 번째 문단입니다.
|
||||
@ -83,7 +83,7 @@ __이 텍스트도 같습니다.__
|
||||
HTML `<br />` 태그를 삽입하고 싶으시다면, 두 개 이상의 띄어쓰기로 문단을 끝내고
|
||||
새 문단을 시작할 수 있습니다.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
띄어쓰기 두 개로 끝나는 문단 (마우스로 긁어 보세요).
|
||||
|
||||
이 위에는 `<br />` 태그가 있습니다.
|
||||
@ -91,7 +91,7 @@ HTML `<br />` 태그를 삽입하고 싶으시다면, 두 개 이상의 띄어
|
||||
|
||||
인용문은 > 문자로 쉽게 쓸 수 있습니다.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
> 인용문입니다. 수동으로 개행하고서
|
||||
> 줄마다 `>`를 칠 수도 있고 줄을 길게 쓴 다음에 저절로 개행되게 내버려 둘 수도 있습니다.
|
||||
> `>`로 시작하기만 한다면 차이가 없습니다.
|
||||
@ -103,7 +103,7 @@ HTML `<br />` 태그를 삽입하고 싶으시다면, 두 개 이상의 띄어
|
||||
|
||||
## 목록
|
||||
순서가 없는 목록은 별표, 더하기, 하이픈을 이용해 만들 수 있습니다.
|
||||
```markdown
|
||||
```md
|
||||
* 이거
|
||||
* 저거
|
||||
* 그거
|
||||
@ -111,7 +111,7 @@ HTML `<br />` 태그를 삽입하고 싶으시다면, 두 개 이상의 띄어
|
||||
|
||||
또는
|
||||
|
||||
```markdown
|
||||
```md
|
||||
+ 이거
|
||||
+ 저거
|
||||
+ 그거
|
||||
@ -119,7 +119,7 @@ HTML `<br />` 태그를 삽입하고 싶으시다면, 두 개 이상의 띄어
|
||||
|
||||
또는
|
||||
|
||||
```markdown
|
||||
```md
|
||||
- 이거
|
||||
- 저거
|
||||
- 그거
|
||||
@ -127,7 +127,7 @@ HTML `<br />` 태그를 삽입하고 싶으시다면, 두 개 이상의 띄어
|
||||
|
||||
순서가 있는 목록은 숫자와 마침표입니다.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
1. 하나
|
||||
2. 둘
|
||||
3. 셋
|
||||
@ -135,7 +135,7 @@ HTML `<br />` 태그를 삽입하고 싶으시다면, 두 개 이상의 띄어
|
||||
|
||||
숫자를 정확히 붙이지 않더라도 제대로 된 순서로 보여주겠지만, 좋은 생각은 아닙니다.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
1. 하나
|
||||
1. 둘
|
||||
1. 셋
|
||||
@ -144,7 +144,7 @@ HTML `<br />` 태그를 삽입하고 싶으시다면, 두 개 이상의 띄어
|
||||
|
||||
목록 안에 목록이 올 수도 있습니다.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
1. 하나
|
||||
2. 둘
|
||||
3. 셋
|
||||
@ -155,7 +155,7 @@ HTML `<br />` 태그를 삽입하고 싶으시다면, 두 개 이상의 띄어
|
||||
|
||||
심지어 할 일 목록도 있습니다. HTML 체크박스가 만들어집니다.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
x가 없는 박스들은 체크되지 않은 HTML 체크박스입니다.
|
||||
- [ ] 첫 번째 할 일
|
||||
- [ ] 두 번째 할 일
|
||||
@ -168,13 +168,13 @@ x가 없는 박스들은 체크되지 않은 HTML 체크박스입니다.
|
||||
띄어쓰기 네 개 혹은 탭 한 개로 줄을 들여씀으로서 (`<code> 요소를 사용하여`) 코드를
|
||||
나타낼 수 있습니다.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
puts "Hello, world!"
|
||||
```
|
||||
|
||||
탭을 더 치거나 띄어쓰기를 네 번 더 함으로써 코드를 들여쓸 수 있습니다.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
my_array.each do |item|
|
||||
puts item
|
||||
end
|
||||
@ -182,7 +182,7 @@ x가 없는 박스들은 체크되지 않은 HTML 체크박스입니다.
|
||||
|
||||
인라인 코드는 백틱 문자를 이용하여 나타냅니다. `
|
||||
|
||||
```markdown
|
||||
```md
|
||||
철수는 `go_to()` 함수가 뭘 했는지도 몰랐어!
|
||||
```
|
||||
|
||||
@ -202,7 +202,7 @@ end
|
||||
|
||||
수평선(`<hr/>`)은 셋 이상의 별표나 하이픈을 이용해 쉽게 나타낼 수 있습니다.
|
||||
띄어쓰기가 포함될 수 있습니다.
|
||||
```markdown
|
||||
```md
|
||||
***
|
||||
---
|
||||
- - -
|
||||
@ -213,19 +213,19 @@ end
|
||||
마크다운의 장점 중 하나는 링크를 만들기 쉽다는 것입니다. 대괄호 안에 나타낼 텍스트를 쓰고
|
||||
괄호 안에 URL을 쓰면 됩니다.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
[클릭](http://test.com/)
|
||||
```
|
||||
|
||||
괄호 안에 따옴표를 이용해 링크에 제목을 달 수도 있습니다.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
[클릭](http://test.com/ "test.com으로 가기")
|
||||
```
|
||||
|
||||
상대 경로도 유효합니다.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
[music으로 가기](/music/).
|
||||
```
|
||||
|
||||
@ -251,7 +251,7 @@ end
|
||||
## 이미지
|
||||
이미지는 링크와 같지만 앞에 느낌표가 붙습니다.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
|
||||
```
|
||||
|
||||
@ -264,18 +264,18 @@ end
|
||||
## 기타
|
||||
### 자동 링크
|
||||
|
||||
```markdown
|
||||
```md
|
||||
<http://testwebsite.com/>와
|
||||
[http://testwebsite.com/](http://testwebsite.com/)는 동일합니다.
|
||||
```
|
||||
|
||||
### 이메일 자동 링크
|
||||
```markdown
|
||||
```md
|
||||
<foo@bar.com>
|
||||
```
|
||||
### 탈출 문자
|
||||
|
||||
```markdown
|
||||
```md
|
||||
*별표 사이에 이 텍스트*를 치고 싶지만 기울이고 싶지는 않다면
|
||||
이렇게 하시면 됩니다. \*별표 사이에 이 텍스트\*.
|
||||
```
|
||||
@ -284,7 +284,7 @@ end
|
||||
|
||||
깃헙 전용 마크다운에서는 `<kbd>` 태그를 이용해 키보드 키를 나타낼 수 있습니다.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
컴퓨터가 멈췄다면 눌러보세요.
|
||||
<kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd>
|
||||
```
|
||||
@ -292,14 +292,14 @@ end
|
||||
### 표
|
||||
|
||||
표는 깃헙 전용 마크다운에서만 쓸 수 있고 다소 복잡하지만, 정말 쓰고 싶으시다면
|
||||
```markdown
|
||||
```md
|
||||
| 1열 | 2열 | 3열 |
|
||||
| :--------| :-------: | --------: |
|
||||
| 왼쪽 정렬 | 가운데 정렬 | 오른쪽 정렬 |
|
||||
| 머시기 | 머시기 | 머시기 |
|
||||
```
|
||||
혹은
|
||||
```markdown
|
||||
```md
|
||||
1열 | 2열 | 3열
|
||||
:-- | :-: | --:
|
||||
으악 너무 못생겼어 | 그만 | 둬
|
||||
|
||||
@ -50,7 +50,7 @@ HTML-элементы от <h1> до <h6> размечаются очень пр
|
||||
текст, который должен стать заголовком, предваряется
|
||||
соответствующим количеством символов "#":
|
||||
|
||||
```markdown
|
||||
```md
|
||||
# Это заголовок h1
|
||||
## Это заголовок h2
|
||||
### Это заголовок h3
|
||||
@ -60,7 +60,7 @@ HTML-элементы от <h1> до <h6> размечаются очень пр
|
||||
```
|
||||
Markdown позволяет размечать заголовки <h1> и <h2> ещё одним способом:
|
||||
|
||||
```markdown
|
||||
```md
|
||||
Это заголовок h1
|
||||
================
|
||||
|
||||
@ -72,7 +72,7 @@ Markdown позволяет размечать заголовки <h1> и <h2>
|
||||
|
||||
Текст легко сделать полужирным и/или курсивным:
|
||||
|
||||
```markdown
|
||||
```md
|
||||
*Этот текст будет выведен курсивом.*
|
||||
_Так же, как этот._
|
||||
|
||||
@ -87,7 +87,7 @@ __И этот тоже.__
|
||||
В Github Flavored Markdown, стандарте, который используется в Github,
|
||||
текст также можно сделать зачёркнутым:
|
||||
|
||||
```markdown
|
||||
```md
|
||||
~~Зачёркнутый текст.~~
|
||||
```
|
||||
|
||||
@ -96,7 +96,7 @@ __И этот тоже.__
|
||||
Абзацами являются любые строки, следующие друг за другом.
|
||||
Разделяются же абзацы одной или несколькими пустыми строками:
|
||||
|
||||
```markdown
|
||||
```md
|
||||
Это абзац. Я печатаю в абзаце, разве это не прикольно?
|
||||
|
||||
А тут уже абзац №2.
|
||||
@ -108,7 +108,7 @@ __И этот тоже.__
|
||||
|
||||
Для вставки принудительных переносов можно завершить абзац двумя дополнительными пробелами:
|
||||
|
||||
```markdown
|
||||
```md
|
||||
Эта строка завершается двумя пробелами (выделите, чтобы увидеть!).
|
||||
|
||||
Над этой строкой есть <br />!
|
||||
@ -116,7 +116,7 @@ __И этот тоже.__
|
||||
|
||||
Цитаты размечаются с помощью символа «>»:
|
||||
|
||||
```markdown
|
||||
```md
|
||||
> Это цитата. В цитатах можно
|
||||
> принудительно переносить строки, вставляя «>» в начало каждой следующей строки. А можно просто оставлять их достаточно длинными, и такие длинные строки будут перенесены автоматически.
|
||||
> Разницы между этими двумя подходами к переносу строк нет, коль скоро
|
||||
@ -133,7 +133,7 @@ __И этот тоже.__
|
||||
одного из символов «*», «+» или «-»:
|
||||
(символ должен быть одним и тем же для всех элементов)
|
||||
|
||||
```markdown
|
||||
```md
|
||||
* Список,
|
||||
* Размеченный
|
||||
* Звёздочками
|
||||
@ -154,7 +154,7 @@ __И этот тоже.__
|
||||
В нумерованных списках каждая строка начинается
|
||||
с числа и точки вслед за ним:
|
||||
|
||||
```markdown
|
||||
```md
|
||||
1. Первый элемент
|
||||
2. Второй элемент
|
||||
3. Третий элемент
|
||||
@ -164,7 +164,7 @@ __И этот тоже.__
|
||||
любое число в начале каждого элемента, и парсер пронумерует элементы сам!
|
||||
Правда, злоупотреблять этим не стоит :)
|
||||
|
||||
```markdown
|
||||
```md
|
||||
1. Первый элемент
|
||||
1. Второй элемент
|
||||
1. Третий элемент
|
||||
@ -173,7 +173,7 @@ __И этот тоже.__
|
||||
|
||||
Списки могут быть вложенными:
|
||||
|
||||
```markdown
|
||||
```md
|
||||
1. Введение
|
||||
2. Начало работы
|
||||
3. Примеры использования
|
||||
@ -184,7 +184,7 @@ __И этот тоже.__
|
||||
|
||||
Можно даже делать списки задач. Блок ниже создаёт HTML-флажки.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
Для отметки флажка используйте «x»
|
||||
- [ ] Первая задача
|
||||
- [ ] Вторая задача
|
||||
@ -197,7 +197,7 @@ __И этот тоже.__
|
||||
Фрагменты исходного кода (обычно отмечаемые тегом `<code>`) выделяются просто:
|
||||
каждая строка блока должна иметь отступ в четыре пробела либо в один символ табуляции.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
Это код,
|
||||
причём многострочный
|
||||
```
|
||||
@ -205,7 +205,7 @@ __И этот тоже.__
|
||||
Вы также можете делать дополнительные отступы, добавляя символы табуляции
|
||||
или по четыре пробела:
|
||||
|
||||
```markdown
|
||||
```md
|
||||
my_array.each do |item|
|
||||
puts item
|
||||
end
|
||||
@ -215,7 +215,7 @@ __И этот тоже.__
|
||||
не выделяя код в блок. Для этого фрагменты кода нужно обрамлять
|
||||
символами «`»:
|
||||
|
||||
```markdown
|
||||
```md
|
||||
Ваня даже не знал, что делает функция `go_to()`!
|
||||
```
|
||||
|
||||
@ -237,7 +237,7 @@ end
|
||||
Разделители (`<hr>`) добавляются вставкой строки из трёх и более
|
||||
(одинаковых) символов «*» или «-», с пробелами или без них:
|
||||
|
||||
```markdown
|
||||
```md
|
||||
***
|
||||
---
|
||||
- - -
|
||||
@ -251,18 +251,18 @@ end
|
||||
текст ссылки, заключив его в квадратные скобки,
|
||||
и сразу после — URL-адрес, заключенный в круглые
|
||||
|
||||
```markdown
|
||||
```md
|
||||
[Ссылка!](http://test.com/)
|
||||
```
|
||||
Также для ссылки можно указать всплывающую подсказку (`title`), используя
|
||||
кавычки внутри круглых скобок:
|
||||
|
||||
```markdown
|
||||
```md
|
||||
[Ссылка!](http://test.com/ "Ссылка на Test.com")
|
||||
```
|
||||
Относительные пути тоже возможны:
|
||||
|
||||
```markdown
|
||||
```md
|
||||
[Перейти к музыке](/music/).
|
||||
```
|
||||
|
||||
@ -290,7 +290,7 @@ Markdown также позволяет размечать ссылку в вид
|
||||
Разметка изображений очень похожа на разметку ссылок.
|
||||
Нужно всего лишь добавить перед ссылкой восклицательный знак!
|
||||
|
||||
```markdown
|
||||
```md
|
||||
|
||||
```
|
||||
Изображения тоже могут быть оформлены, как сноски.
|
||||
@ -301,20 +301,20 @@ Markdown также позволяет размечать ссылку в вид
|
||||
## Разное
|
||||
### Автоссылки
|
||||
|
||||
```markdown
|
||||
```md
|
||||
Ссылка вида <http://testwebsite.com/> эквивалентна
|
||||
[http://testwebsite.com/](http://testwebsite.com/)
|
||||
```
|
||||
|
||||
### Автоссылки для адресов электронной почты
|
||||
|
||||
```markdown
|
||||
```md
|
||||
<foo@bar.com>
|
||||
```
|
||||
|
||||
### Экранирование символов
|
||||
|
||||
```markdown
|
||||
```md
|
||||
Я хочу напечатать *текст, заключённый в звёздочки*, но я не хочу,
|
||||
чтобы он был курсивным. Тогда я делаю так:
|
||||
\*Текст, заключённый в звёздочки\*
|
||||
@ -324,7 +324,7 @@ Markdown также позволяет размечать ссылку в вид
|
||||
В Github Flavored Markdown для представления клавиш на клавиатуре
|
||||
вы можете использовать тег `<kbd>`.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
Ваш компьютер завис? Попробуйте нажать
|
||||
<kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd>
|
||||
```
|
||||
@ -334,7 +334,7 @@ Markdown также позволяет размечать ссылку в вид
|
||||
да и синтаксис имеют не слишком удобный.
|
||||
Но если очень нужно, размечайте таблицы так:
|
||||
|
||||
```markdown
|
||||
```md
|
||||
| Столбец 1 | Столбец 2 | Столбец 3 |
|
||||
| :----------- | :----------: | -----------: |
|
||||
| Выравнивание | Выравнивание | Выравнивание |
|
||||
@ -342,7 +342,7 @@ Markdown также позволяет размечать ссылку в вид
|
||||
```
|
||||
Или более компактно
|
||||
|
||||
```markdown
|
||||
```md
|
||||
Столбец 1|Столбец 2|Столбец 3
|
||||
:--|:-:|--:
|
||||
Выглядит|это|страшновато...
|
||||
|
||||
@ -1,32 +0,0 @@
|
||||
#!/usr/bin/env ruby
|
||||
require 'charlock_holmes'
|
||||
$file_count = 0;
|
||||
markdown_files = Dir["./**/*.html.markdown"]
|
||||
markdown_files.each do |file|
|
||||
begin
|
||||
contents = File.read(file)
|
||||
detection = CharlockHolmes::EncodingDetector.detect(contents)
|
||||
case detection[:encoding]
|
||||
when 'UTF-8'
|
||||
$file_count = $file_count + 1
|
||||
when 'ISO-8859-1'
|
||||
$file_count = $file_count + 1
|
||||
when /ISO-8859/
|
||||
puts "Notice: #{file} was detected as #{detection[:encoding]} encoding. Everything is probably fine."
|
||||
$file_count = $file_count + 1
|
||||
else
|
||||
puts "WARNING #{file} was detected as #{detection[:encoding]} encoding. Please save the file in UTF-8!"
|
||||
end
|
||||
rescue Exception => msg
|
||||
puts msg
|
||||
end
|
||||
end
|
||||
files_failed = markdown_files.length - $file_count
|
||||
if files_failed != 0
|
||||
puts "FAILURE!!! #{files_failed} files were unable to be validated as UTF-8!"
|
||||
puts "Please resave the file as UTF-8."
|
||||
exit 1
|
||||
else
|
||||
puts "Success. All #{$file_count} files passed UTF-8 validity checks."
|
||||
exit 0
|
||||
end
|
||||
@ -1,21 +0,0 @@
|
||||
#!/usr/bin/env ruby
|
||||
require 'yaml';
|
||||
$file_count = 0;
|
||||
markdown_files = Dir["./**/*.html.markdown"]
|
||||
markdown_files.each do |file|
|
||||
begin
|
||||
YAML.load_file(file)
|
||||
$file_count = $file_count + 1
|
||||
rescue Exception => msg
|
||||
puts msg
|
||||
end
|
||||
end
|
||||
files_failed = markdown_files.length - $file_count
|
||||
if files_failed != 0
|
||||
puts "FAILURE!!! #{files_failed} files were unable to be parsed!"
|
||||
puts "Please check the YAML headers for the documents that failed!"
|
||||
exit 1
|
||||
else
|
||||
puts "All #{$file_count} files were verified valid YAML"
|
||||
exit 0
|
||||
end
|
||||
@ -28,7 +28,7 @@ Markdown có sự khác biệt trong cách cài đặt giữa các trình phân
|
||||
## 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.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
<!-- Điều này đồng nghĩa ta có thể sử dụng các phần tử HTML
|
||||
trong Markdown, ví dụ như phần tử chú thích/comment.
|
||||
Tuy nhiên, nếu sử dụng một phần tử HTML trong file Markdown,
|
||||
@ -40,7 +40,7 @@ ta không thể sử dụng cú pháp Markdown cho nội dung bên trong phần
|
||||
Ta có thể tạo các phần tử đầu mục HTML từ `<h1>` cho đến `<h6>` dễ dàng
|
||||
bằng cách thêm số lượng dấu thăng (#) đằng trước chuỗi cần tạo đầu mục.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
# Đây là đầu mục <h1>
|
||||
## Đây là đầu mục <h2>
|
||||
### Đây là đầu mục <h3>
|
||||
@ -50,7 +50,7 @@ bằng cách thêm số lượng dấu thăng (#) đằng trước chuỗi cần
|
||||
```
|
||||
Markdown còn cung cấp cách khác để tạo đầu mục hạng nhất h1 và hạng nhì h2.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
Đây là đầu mục h1
|
||||
=============
|
||||
|
||||
@ -62,7 +62,7 @@ Markdown còn cung cấp cách khác để tạo đầu mục hạng nhất h1 v
|
||||
|
||||
Văn bản có thể được định dạng dễ dàng như in nghiêng hay làm đậm sử dụng Markdown.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
*Đoạn văn bản này được in nghiêng.*
|
||||
_Và đoạn này cũng như vậy._
|
||||
|
||||
@ -76,7 +76,7 @@ __Và đoạn này cũng vậy.__
|
||||
|
||||
Trong cài đặt Markdown để hiển thị file của GitHub,ta còn có gạch ngang:
|
||||
|
||||
```markdown
|
||||
```md
|
||||
~~Đoạn văn bản này được gạch ngang.~~
|
||||
```
|
||||
## Đoạn văn
|
||||
@ -84,7 +84,7 @@ Trong cài đặt Markdown để hiển thị file của GitHub,ta còn có gạ
|
||||
Đoạn văn bao gồm một hay nhiều dòng văn bản liên tiếp nhau được phân cách
|
||||
bởi một hay nhiều dòng trống.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
Đây là đoạn văn thứ nhất.
|
||||
|
||||
Đây là đoạn văn thứ hai.
|
||||
@ -97,7 +97,7 @@ Dòng này vẫn thuộc đoạn văn thứ hai, do không có cách dòng.
|
||||
Nếu cần chèn thêm thẻ ngắt dòng `<br />` của HTML, ta có thể kết thúc đoạn văn bản
|
||||
bằng cách thêm vào từ 2 dấu cách (space) trở lên và bắt đầu đoạn văn bản mới.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
Dòng này kết thúc với 2 dấu cách (highlight để nhìn thấy).
|
||||
|
||||
Có phần tử <br /> ở bên trên.
|
||||
@ -105,7 +105,7 @@ Có phần tử <br /> ở bên trên.
|
||||
|
||||
Khối trích dẫn được sử dụng với kí tự >
|
||||
|
||||
```markdown
|
||||
```md
|
||||
> Đây là khối trích dẫn. Ta có thể
|
||||
> ngắt dòng thủ công và thêm kí tự `>` trước mỗi dòng hoặc ta có thể để dòng tự ngắt nếu cần thiệt khi quá dài.
|
||||
> Không có sự khác biệt nào, chỉ cần nó bắt đầu với kí tự `>`
|
||||
@ -120,7 +120,7 @@ Khối trích dẫn được sử dụng với kí tự >
|
||||
|
||||
Danh sách không có thứ tự có thể được tạo sử dụng dấu sao, dấu cộng hay dấu trừ đầu dòng.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
* Một mục
|
||||
* Một mục
|
||||
* Một mục nữa
|
||||
@ -140,7 +140,7 @@ hay
|
||||
|
||||
Danh sách có thứ tự được tạo bởi một số theo sau bằng một dấu chấm.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
1. Mục thứ nhất
|
||||
2. Mục thứ hai
|
||||
3. Mục thứ ba
|
||||
@ -148,7 +148,7 @@ Danh sách có thứ tự được tạo bởi một số theo sau bằng một
|
||||
|
||||
Ta không nhất thiết phải điền số thứ thự cho chỉ mục đúng mà Markdown sẽ tự hiển thị danh sách theo thứ tự đã được sắp xếp, tuy nhiên cách làm này không tốt!
|
||||
|
||||
```markdown
|
||||
```md
|
||||
1. Mục thứ nhất
|
||||
1. Mục thứ hai
|
||||
1. Mục thứ ba
|
||||
@ -157,7 +157,7 @@ Ta không nhất thiết phải điền số thứ thự cho chỉ mục đúng
|
||||
|
||||
Ta còn có thể sử dụng danh sách con
|
||||
|
||||
```markdown
|
||||
```md
|
||||
1. Mục thứ nhất
|
||||
2. Mục thứ hai
|
||||
3. Mục thứ ba
|
||||
@ -168,7 +168,7 @@ Ta còn có thể sử dụng danh sách con
|
||||
|
||||
Markdown còn cung cấp danh mục (checklist). Nó sẽ hiển thị ra hộp đánh dấu dạng HTML.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
Boxes below without the 'x' are unchecked HTML checkboxes.
|
||||
- [ ] First task to complete.
|
||||
- [ ] Second task that needs done
|
||||
@ -180,14 +180,14 @@ This checkbox below will be a checked HTML checkbox.
|
||||
|
||||
Ta có thể đánh dấu một đoạn code (tương tự sử dụng phần tử HTML `<code>`) bằng việc thụt đầu dòng sử dụng bốn dấu cách (space) hoặc một dấu nhảy (tab)
|
||||
|
||||
```markdown
|
||||
```md
|
||||
This is code
|
||||
So is this
|
||||
```
|
||||
|
||||
Ta còn có thể thêm dấu nhảy (hoặc thêm vào bốn dấu cách nữa) để căn chỉnh phần bên trong đoạn code
|
||||
|
||||
```markdown
|
||||
```md
|
||||
my_array.each do |item|
|
||||
puts item
|
||||
end
|
||||
@ -195,7 +195,7 @@ Ta còn có thể thêm dấu nhảy (hoặc thêm vào bốn dấu cách nữa)
|
||||
|
||||
Code hiển thị cùng dòng có thể được đánh dấu sử dụng cặp ``.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
John didn't even know what the `go_to()` function did!
|
||||
```
|
||||
|
||||
@ -217,7 +217,7 @@ highlighting of the language you specify after the \`\`\`
|
||||
Dòng kẻ ngang (`<hr />`) có thể được thêm vào dễ dàng sử dụng từ 3 kí tự sao (*) hoặc gạch ngang (-), không quan trọng có khoảng cách giữa các kí tự hay không.
|
||||
|
||||
|
||||
```markdown
|
||||
```md
|
||||
***
|
||||
---
|
||||
- - -
|
||||
@ -228,17 +228,17 @@ Dòng kẻ ngang (`<hr />`) có thể được thêm vào dễ dàng sử dụng
|
||||
|
||||
Một trong những thứ tốt nhất khi làm việc với Markdown là khả năng tạo liên kết hết sức dễ dàng. Đoạn text hiển thị được đóng trong cặp ngoặc vuông [] kèm theo đường dẫn url trong cặp ngoặc tròn ().
|
||||
|
||||
```markdown
|
||||
```md
|
||||
[Click me!](http://test.com/)
|
||||
```
|
||||
Ta còn có thể tạo tiêu đề cho liên kết sử dụng cặp ngoặc nháy bên trong cặp ngoặc tròn
|
||||
|
||||
```markdown
|
||||
```md
|
||||
[Click me!](http://test.com/ "Link to Test.com")
|
||||
```
|
||||
Đường dẫn tương đối cũng hoạt động.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
[Go to music](/music/).
|
||||
```
|
||||
|
||||
@ -264,7 +264,7 @@ Nhưng nó không được sử dụng rộng rãi.
|
||||
|
||||
Hiển thị ảnh tương tự như liên kết nhưng có thêm dấu chấm than đằng trước
|
||||
|
||||
```markdown
|
||||
```md
|
||||
|
||||
```
|
||||
|
||||
@ -278,20 +278,20 @@ Và kiểu tham chiếu cũng hoạt động như vậy.
|
||||
|
||||
### Tự động đặt liên kết
|
||||
|
||||
```markdown
|
||||
```md
|
||||
<http://testwebsite.com/> tương đương với
|
||||
[http://testwebsite.com/](http://testwebsite.com/)
|
||||
```
|
||||
|
||||
### Tự động đặt liên kết cho email
|
||||
|
||||
```markdown
|
||||
```md
|
||||
<foo@bar.com>
|
||||
```
|
||||
|
||||
### Hiển thị Kí tự đặc biệt
|
||||
|
||||
```markdown
|
||||
```md
|
||||
Khi ta muốn viết *đoạn văn bản này có dấu sao bao quanh* nhưng ta không muốn nó bị in nghiêng, ta có thể sử dụng: \*đoạn văn bản này có dấu sao bao quanh\*.
|
||||
```
|
||||
|
||||
@ -299,7 +299,7 @@ Khi ta muốn viết *đoạn văn bản này có dấu sao bao quanh* nhưng ta
|
||||
|
||||
Trong Markdown của Github, ta có thể sử dụng thẻ `<kbd>` để thay cho phím trên bàn phím.
|
||||
|
||||
```markdown
|
||||
```md
|
||||
Máy treo? Thử bấm tổ hợp
|
||||
<kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd>
|
||||
```
|
||||
@ -307,7 +307,7 @@ Máy treo? Thử bấm tổ hợp
|
||||
|
||||
Bảng biểu được hỗ trợ trên Markdown của GitHub, Jira, Trello, v.v và khá khó viết:
|
||||
|
||||
```markdown
|
||||
```md
|
||||
| Cột 1 | Cột2 | Cột 3 |
|
||||
| :----------- | :------: | ------------: |
|
||||
| Căn trái | Căn giữa | Căn phải |
|
||||
@ -315,7 +315,7 @@ Bảng biểu được hỗ trợ trên Markdown của GitHub, Jira, Trello, v.v
|
||||
```
|
||||
Hoặc có thể sử dụng kết quả dưới đây
|
||||
|
||||
```markdown
|
||||
```md
|
||||
Cột 1 | Cột 2 | Cột 3
|
||||
:-- | :-: | --:
|
||||
blah | blah | blah
|
||||
|
||||
Loading…
Reference in New Issue
Block a user