mirror of
https://github.com/adambard/learnxinyminutes-docs.git
synced 2024-12-23 09:41:36 +00:00
Fix syntax highlighting for Markdown
This commit is contained in:
Boris Verkhovskiy
parent
1708b6c95c
commit
365200ce0a
@ -215,7 +215,7 @@ Pro ještě hlubší odsazení můžete přidat další 4 mezery nebo další ta
|
||||
|
||||
```md
|
||||
moje_pole.each do |i|
|
||||
puts i
|
||||
puts i
|
||||
end
|
||||
```
|
||||
|
||||
@ -228,11 +228,13 @@ Honza neměl tušení, co dělá funkce `go_to()`!
|
||||
|
||||
V Markdownu od GitHubu, můžete použít speciální syntaxi pro kód:
|
||||
|
||||
<pre><code class="highlight">```ruby
|
||||
````md
|
||||
```ruby
|
||||
def neco
|
||||
puts "Ahoj světe!"
|
||||
puts "Ahoj světe!"
|
||||
end
|
||||
```</code></pre>
|
||||
```
|
||||
````
|
||||
|
||||
Text výše nepotřebuje čtyřmezerové odsazení a parser navíc použije zvýraznění
|
||||
syntaxe pro zvolený jazyk.
|
||||
|
||||
@ -178,7 +178,7 @@ Vous pouvez également utiliser des sous-listes.
|
||||
1. Item un
|
||||
2. Item deux
|
||||
3. Item trois
|
||||
* Sub-item
|
||||
* Sub-item
|
||||
* Sub-item
|
||||
4. Item quatre
|
||||
```
|
||||
@ -210,7 +210,7 @@ l'intérieur du bloc de code.
|
||||
|
||||
```md
|
||||
my_array.each do |item|
|
||||
puts item
|
||||
puts item
|
||||
end
|
||||
```
|
||||
|
||||
@ -223,13 +223,15 @@ La fonction `run()` ne vous oblige pas à aller courir!
|
||||
|
||||
En Markdown GitHub, vous pouvez utiliser des syntaxes spécifiques.
|
||||
|
||||
```ruby
|
||||
def foobar
|
||||
puts "Hello world!"
|
||||
end
|
||||
```
|
||||
````md
|
||||
```ruby
|
||||
def foobar
|
||||
puts "Hello world!"
|
||||
end
|
||||
```
|
||||
````
|
||||
|
||||
Pas besoin d'indentation pour le code juste au-dessus, de plus, GitHub
|
||||
Pas besoin d'indentation pour le code juste au-dessus, de plus, GitHub
|
||||
va utiliser une coloration syntaxique pour le langage indiqué après les <code>```</code>.
|
||||
|
||||
## Ligne Horizontale
|
||||
@ -267,13 +269,13 @@ Markdown supporte aussi les liens relatifs.
|
||||
|
||||
Les liens de références sont eux aussi disponibles en Markdown.
|
||||
|
||||
<div class="highlight"><code><pre>
|
||||
[<span class="nv">Cliquez ici</span>][<span class="ss">link1</span>] pour plus d'information!
|
||||
[<span class="nv">Regardez aussi par ici</span>][<span class="ss">foobar</span>] si vous voulez.
|
||||
```md
|
||||
[Cliquez ici][link1] pour plus d'information!
|
||||
[Regardez aussi par ici][foobar] si vous voulez.
|
||||
|
||||
[<span class="nv">link1</span>]: <span class="sx">http://test.com/</span> <span class="nn">"Cool!"</span>
|
||||
[<span class="nv">foobar</span>]: <span class="sx">http://foobar.biz/</span> <span class="nn">"Génial!"</span>
|
||||
</pre></code></div>
|
||||
[link1]: http://test.com/ "Cool!"
|
||||
[foobar]: http://foobar.biz/ "Génial!"
|
||||
```
|
||||
|
||||
Le titre peut aussi être entouré de guillemets simples, ou de parenthèses, ou
|
||||
absent. Les références peuvent être placées où vous voulez dans le document et
|
||||
@ -282,11 +284,11 @@ les identifiants peuvent être n'importe quoi tant qu'ils sont uniques.
|
||||
Il y a également le nommage implicite qui transforme le texte du lien en
|
||||
identifiant.
|
||||
|
||||
<div class="highlight"><code><pre>
|
||||
[<span class="nv">Ceci</span>][] est un lien.
|
||||
```md
|
||||
[Ceci][] est un lien.
|
||||
|
||||
[<span class="nv">Ceci</span>]:<span class="sx">http://ceciestunlien.com/</span>
|
||||
</pre></code></div>
|
||||
[Ceci]:http://ceciestunlien.com/
|
||||
```
|
||||
|
||||
Mais ce n'est pas beaucoup utilisé.
|
||||
|
||||
@ -301,12 +303,11 @@ d'un point d'exclamation!
|
||||
|
||||
Là aussi, on peut utiliser le mode "références".
|
||||
|
||||
```md
|
||||
![Ceci est l'attribut ALT de l'image][monimage]
|
||||
|
||||
<div class="highlight"><code><pre>
|
||||
![<span class="nv">Ceci est l'attribut ALT de l'image</span>][<span class="ss">monimage</span>]
|
||||
|
||||
[<span class="nv">monimage</span>]: <span class="sx">relative/urls/cool/image.jpg</span> <span class="nn">"si vous voulez un titre, c'est ici."</span>
|
||||
</pre></code></div>
|
||||
[monimage]: relative/urls/cool/image.jpg "si vous voulez un titre, c'est ici."
|
||||
```
|
||||
|
||||
## Divers
|
||||
|
||||
@ -348,10 +349,10 @@ Les tableaux ne sont disponibles que dans le "GitHub Flavored Markdown" et
|
||||
ne sont pas tres agréable d'utilisation. Mais si vous en avez besoin :
|
||||
|
||||
```md
|
||||
| Col1 | Col2 | Col3 |
|
||||
| :----------- | :------: | ------------: |
|
||||
| Alignement Gauche | Centré | Alignement Droite |
|
||||
| bla | bla | bla |
|
||||
| Col1 | Col2 | Col3 |
|
||||
| :---------------- | :------: | ----------------: |
|
||||
| Alignement Gauche | Centré | Alignement Droite |
|
||||
| bla | bla | bla |
|
||||
```
|
||||
|
||||
ou bien, pour un résultat équivalent :
|
||||
|
||||
@ -183,7 +183,7 @@ Potete inoltre inserire un altro tab (o altri quattro spazi) per indentare il vo
|
||||
|
||||
```md
|
||||
my_array.each do |item|
|
||||
puts item
|
||||
puts item
|
||||
end
|
||||
```
|
||||
|
||||
@ -194,12 +194,15 @@ Giovanni non sapeva neppure a cosa servisse la funzione `go_to()`!
|
||||
```
|
||||
|
||||
In Github Flavored Markdown, potete inoltre usare una sintassi speciale per il codice
|
||||
<pre>
|
||||
<code class="highlight">```ruby
|
||||
|
||||
````md
|
||||
```ruby
|
||||
def foobar
|
||||
puts "Hello world!"
|
||||
puts "Hello world!"
|
||||
end
|
||||
```</code></pre>
|
||||
```
|
||||
````
|
||||
|
||||
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
|
||||
|
||||
@ -25,15 +25,18 @@ lang: ko-kr
|
||||
|
||||
## HTML 요소
|
||||
HTML은 마크다운의 수퍼셋입니다. 모든 HTML 파일은 유효한 마크다운이라는 것입니다.
|
||||
|
||||
```md
|
||||
<!--따라서 주석과 같은 HTML 요소들을 마크다운에 사용할 수 있으며, 마크다운 파서에 영향을
|
||||
받지 않을 것입니다. 하지만 마크다운 파일에서 HTML 요소를 만든다면 그 요소의 안에서는
|
||||
마크다운 문법을 사용할 수 없습니다.-->
|
||||
```
|
||||
|
||||
## 제목
|
||||
|
||||
텍스트 앞에 붙이는 우물 정 기호(#)의 갯수에 따라 `<h1>`부터 `<h6>`까지의 HTML 요소를
|
||||
손쉽게 작성할 수 있습니다.
|
||||
|
||||
```md
|
||||
# <h1>입니다.
|
||||
## <h2>입니다.
|
||||
@ -42,7 +45,9 @@ HTML은 마크다운의 수퍼셋입니다. 모든 HTML 파일은 유효한 마
|
||||
##### <h5>입니다.
|
||||
###### <h6>입니다.
|
||||
```
|
||||
|
||||
또한 h1과 h2를 나타내는 다른 방법이 있습니다.
|
||||
|
||||
```md
|
||||
h1입니다.
|
||||
=============
|
||||
@ -50,9 +55,11 @@ h1입니다.
|
||||
h2입니다.
|
||||
-------------
|
||||
```
|
||||
|
||||
## 간단한 텍스트 꾸미기
|
||||
|
||||
마크다운으로 쉽게 텍스트를 기울이거나 굵게 할 수 있습니다.
|
||||
|
||||
```md
|
||||
*기울인 텍스트입니다.*
|
||||
_이 텍스트도 같습니다._
|
||||
@ -64,10 +71,13 @@ __이 텍스트도 같습니다.__
|
||||
**_이 텍스트도 같습니다._**
|
||||
*__이것도 같습니다.__*
|
||||
```
|
||||
|
||||
깃헙 전용 마크다운에는 취소선도 있습니다.
|
||||
|
||||
```md
|
||||
~~이 텍스트에는 취소선이 그려집니다.~~
|
||||
```
|
||||
|
||||
## 문단
|
||||
|
||||
문단은 하나 이상의 빈 줄로 구분되는, 한 줄 이상의 인접한 텍스트입니다.
|
||||
@ -103,6 +113,7 @@ HTML `<br />` 태그를 삽입하고 싶으시다면, 두 개 이상의 띄어
|
||||
|
||||
## 목록
|
||||
순서가 없는 목록은 별표, 더하기, 하이픈을 이용해 만들 수 있습니다.
|
||||
|
||||
```md
|
||||
* 이거
|
||||
* 저거
|
||||
@ -140,6 +151,7 @@ HTML `<br />` 태그를 삽입하고 싶으시다면, 두 개 이상의 띄어
|
||||
1. 둘
|
||||
1. 셋
|
||||
```
|
||||
|
||||
(위의 예시와 똑같이 나타납니다.)
|
||||
|
||||
목록 안에 목록이 올 수도 있습니다.
|
||||
@ -176,7 +188,7 @@ x가 없는 박스들은 체크되지 않은 HTML 체크박스입니다.
|
||||
|
||||
```md
|
||||
my_array.each do |item|
|
||||
puts item
|
||||
puts item
|
||||
end
|
||||
```
|
||||
|
||||
@ -188,12 +200,13 @@ x가 없는 박스들은 체크되지 않은 HTML 체크박스입니다.
|
||||
|
||||
깃헙 전용 마크다운에서는 코드를 나타내기 위해 특별한 문법을 쓸 수 있습니다.
|
||||
|
||||
<pre>
|
||||
<code class="highlight">```ruby
|
||||
````md
|
||||
```ruby
|
||||
def foobar
|
||||
puts "Hello world!"
|
||||
puts "Hello world!"
|
||||
end
|
||||
```</code></pre>
|
||||
```
|
||||
````
|
||||
|
||||
위의 경우에 들여쓰기가 필요없을 뿐 아니라 \`\`\` 뒤에 특정해 준 언어의 문법에 따라
|
||||
색을 입혀줄 것입니다.
|
||||
@ -202,12 +215,14 @@ end
|
||||
|
||||
수평선(`<hr/>`)은 셋 이상의 별표나 하이픈을 이용해 쉽게 나타낼 수 있습니다.
|
||||
띄어쓰기가 포함될 수 있습니다.
|
||||
|
||||
```md
|
||||
***
|
||||
---
|
||||
- - -
|
||||
****************
|
||||
```
|
||||
|
||||
## 링크
|
||||
|
||||
마크다운의 장점 중 하나는 링크를 만들기 쉽다는 것입니다. 대괄호 안에 나타낼 텍스트를 쓰고
|
||||
@ -231,20 +246,24 @@ end
|
||||
|
||||
참조하는 식으로 링크를 걸 수도 있습니다.
|
||||
|
||||
<pre><code class="highlight">[<span class="nv">이 </span>][<span class="ss">링크</span>]에서 더 알아보세요!
|
||||
[<span class="nv">원하신다면 </span>][<span class="ss">foobar</span>]도 참고하세요.
|
||||
```md
|
||||
[이 ][링크]에서 더 알아보세요!
|
||||
[원하신다면 ][foobar]도 참고하세요.
|
||||
|
||||
[<span class="nv">링크</span>]: <span class="sx">http://test.com/</span> <span class="nn">"좋아!"</span>
|
||||
[<span class="nv">foobar</span>]: <span class="sx">http://foobar.biz/</span> <span class="nn">"됐다!"</span></code></pre>
|
||||
[링크]: http://test.com/ "좋아!"
|
||||
[foobar]: http://foobar.biz/ "됐다!"
|
||||
```
|
||||
|
||||
제목은 작은 따옴표나 괄호에 들어갈 수도 있고, 완전히 생략할 수도 있습니다. 참조는 문서의
|
||||
어느 곳에든 올 수 있고 참조 ID는 유일하다면 무엇이든 될 수 있습니다.
|
||||
|
||||
링크 텍스트를 ID로 사용하는 "묵시적 이름"도 있습니다.
|
||||
|
||||
<pre><code class="highlight">[<span class="nv">이것</span>][]은 링크입니다.
|
||||
```md
|
||||
[이것][]은 링크입니다.
|
||||
|
||||
[<span class="nv">이것</span>]: <span class="sx">http://thisisalink.com/</span></code></pre>
|
||||
[이것]: http://thisisalink.com/
|
||||
```
|
||||
|
||||
하지만 보통 그렇게 추천하지는 않습니다.
|
||||
|
||||
@ -257,9 +276,11 @@ end
|
||||
|
||||
참조 방식도 가능합니다.
|
||||
|
||||
<pre><code class="highlight">![<span class="nv">alt 속성</span>][<span class="ss">이미지</span>]
|
||||
```md
|
||||
![alt 속성][이미지]
|
||||
|
||||
[<span class="nv">이미지</span>]: <span class="sx">relative/urls/cool/image.jpg</span> <span class="nn">"제목이 필요하다면 여기에"</span></code></pre>
|
||||
[이미지]: relative/urls/cool/image.jpg "제목이 필요하다면 여기에"
|
||||
```
|
||||
|
||||
## 기타
|
||||
### 자동 링크
|
||||
@ -270,9 +291,11 @@ end
|
||||
```
|
||||
|
||||
### 이메일 자동 링크
|
||||
|
||||
```md
|
||||
<foo@bar.com>
|
||||
```
|
||||
|
||||
### 탈출 문자
|
||||
|
||||
```md
|
||||
@ -292,17 +315,21 @@ end
|
||||
### 표
|
||||
|
||||
표는 깃헙 전용 마크다운에서만 쓸 수 있고 다소 복잡하지만, 정말 쓰고 싶으시다면
|
||||
|
||||
```md
|
||||
| 1열 | 2열 | 3열 |
|
||||
| :--------| :-------: | --------: |
|
||||
| 왼쪽 정렬 | 가운데 정렬 | 오른쪽 정렬 |
|
||||
| 머시기 | 머시기 | 머시기 |
|
||||
```
|
||||
|
||||
혹은
|
||||
|
||||
```md
|
||||
1열 | 2열 | 3열
|
||||
:-- | :-: | --:
|
||||
으악 너무 못생겼어 | 그만 | 둬
|
||||
```
|
||||
|
||||
---
|
||||
추가 정보를 위해, 존 그루버의 공식 문법 [(영어) 문서](http://daringfireball.net/projects/markdown/syntax)와 애덤 프릿차드의 훌륭한 [(영어) 치트싯](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet)을 확인하세요.
|
||||
|
||||
@ -207,7 +207,7 @@ inside your code.
|
||||
|
||||
```md
|
||||
my_array.each do |item|
|
||||
puts item
|
||||
puts item
|
||||
end
|
||||
```
|
||||
|
||||
@ -219,12 +219,13 @@ John didn't even know what the `go_to()` function did!
|
||||
|
||||
In GitHub Flavored Markdown, you can use a special syntax for code.
|
||||
|
||||
<pre>
|
||||
<code class="highlight">```ruby
|
||||
````md
|
||||
```ruby
|
||||
def foobar
|
||||
puts "Hello world!"
|
||||
puts "Hello world!"
|
||||
end
|
||||
```</code></pre>
|
||||
```
|
||||
````
|
||||
|
||||
The above text doesn't require indenting, plus GitHub will use syntax
|
||||
highlighting of the language you specify after the opening <code>```</code>.
|
||||
@ -264,11 +265,13 @@ Relative paths work too.
|
||||
|
||||
Markdown also supports reference style links.
|
||||
|
||||
<pre><code class="highlight">[<span class="nv">Click this link</span>][<span class="ss">link1</span>] for more info about it!
|
||||
[<span class="nv">Also check out this link</span>][<span class="ss">foobar</span>] if you want to.
|
||||
```md
|
||||
[Click this link][link1] for more info about it!
|
||||
[Also check out this link][foobar] if you want to.
|
||||
|
||||
[<span class="nv">link1</span>]: <span class="sx">http://test.com/</span> <span class="nn">"Cool!"</span>
|
||||
[<span class="nv">foobar</span>]: <span class="sx">http://foobar.biz/</span> <span class="nn">"Alright!"</span></code></pre>
|
||||
[link1]: http://test.com/ "Cool!"
|
||||
[foobar]: http://foobar.biz/ "Alright!"
|
||||
```
|
||||
|
||||
The title can also be in single quotes or in parentheses, or omitted
|
||||
entirely. The references can be anywhere in your document and the reference IDs
|
||||
@ -276,9 +279,11 @@ can be anything so long as they are unique.
|
||||
|
||||
There is also "implicit naming" which lets you use the link text as the id.
|
||||
|
||||
<pre><code class="highlight">[<span class="nv">This</span>][] is a link.
|
||||
```md
|
||||
[This][] is a link.
|
||||
|
||||
[<span class="nv">This</span>]: <span class="sx">http://thisisalink.com/</span></code></pre>
|
||||
[This]: http://thisisalink.com/
|
||||
```
|
||||
|
||||
But it's not that commonly used.
|
||||
|
||||
@ -311,9 +316,11 @@ Images are done the same way as links but with an exclamation point in front!
|
||||
|
||||
And reference style works as expected.
|
||||
|
||||
<pre><code class="highlight">![<span class="nv">This is the alt-attribute.</span>][<span class="ss">myimage</span>]
|
||||
```md
|
||||
![This is the alt-attribute.][myimage]
|
||||
|
||||
[<span class="nv">myimage</span>]: <span class="sx">relative/urls/cool/image.jpg</span> <span class="nn">"if you need a title, it's here"</span></code></pre>
|
||||
[myimage]: relative/urls/cool/image.jpg "if you need a title, it's here"
|
||||
```
|
||||
|
||||
## Miscellany
|
||||
|
||||
|
||||
@ -8,7 +8,7 @@ translators:
|
||||
- ["Monique Baptista", "https://github.com/bfmonique"]
|
||||
- ["Marcel Ribeiro-Dantas", "https://github.com/mribeirodantas"]
|
||||
|
||||
lang: pt-br
|
||||
lang: pt-br
|
||||
filename: learnmarkdown-pt.md
|
||||
---
|
||||
|
||||
@ -213,8 +213,8 @@ adicionais) para indentação no seu código.
|
||||
|
||||
```md
|
||||
my_array.each do |item|
|
||||
puts item
|
||||
end
|
||||
puts item
|
||||
end
|
||||
```
|
||||
|
||||
Código embutido pode ser criado usando o caractere de crase `` ` ``.
|
||||
@ -225,13 +225,13 @@ John não sabia nem o que a função `go_to()` fazia!
|
||||
|
||||
No GitHub Flavored Markdown, você pode usar uma sintaxe especial para código.
|
||||
|
||||
<pre>
|
||||
<code class="highlight">```ruby
|
||||
````md
|
||||
```ruby
|
||||
def foobar
|
||||
puts "Olá mundo!"
|
||||
puts "Olá mundo!"
|
||||
end
|
||||
```</code></pre>
|
||||
|
||||
```
|
||||
````
|
||||
|
||||
O texto acima não requer indentação, além disso o GitHub vai usar o destaque
|
||||
de sintaxe da linguagem qeu você especificar após a tag <code>```</code>.
|
||||
@ -272,11 +272,13 @@ Caminhos relativos funcionam também.
|
||||
|
||||
O Markdown também suporta links para referências no texto.
|
||||
|
||||
<pre><code class="highlight">[<span class="nv">Clique nesse link</span>][<span class="ss">link1</span>] para mais informações!
|
||||
[<span class="nv">Também cheque esse link</span>][<span class="ss">foobar</span>] se você quiser.
|
||||
```md
|
||||
[Clique nesse link][link1] para mais informações!
|
||||
[Também cheque esse link][foobar] se você quiser.
|
||||
|
||||
[<span class="nv">link1</span>]: <span class="sx">http://test.com/</span> <span class="nn">"Legal!"</span>
|
||||
[<span class="nv">link2r</span>]: <span class="sx">http://foobar.biz/</span> <span class="nn">"Certo!"</span></code></pre>
|
||||
[link1]: http://test.com/ "Legal!"
|
||||
[link2r]: http://foobar.biz/ "Certo!"
|
||||
```
|
||||
|
||||
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
|
||||
@ -285,10 +287,11 @@ IDs de referência podem ser qualquer um, desde que eles sejam únicos.
|
||||
Existe também a "nomeação implícita", que permite que você use o texto do link
|
||||
como o id:
|
||||
|
||||
<pre><code class="highlight">[<span class="nv">Isso</span>][] é um link.
|
||||
|
||||
[<span class="nv">Isso</span>]: <span class="sx">http://thisisalink.com/</span></code></pre>
|
||||
```md
|
||||
[Isso][] é um link.
|
||||
|
||||
[Isso]: http://thisisalink.com/
|
||||
```
|
||||
|
||||
Mas geralmente não são usados.
|
||||
|
||||
@ -322,9 +325,11 @@ exclamação na frente!
|
||||
|
||||
E estilo de referência funciona como esperado
|
||||
|
||||
<pre><code class="highlight">![<span class="nv">Esse é o alt-attribute.</span>][<span class="ss">myimage</span>]
|
||||
```md
|
||||
![Esse é o alt-attribute.][myimage]
|
||||
|
||||
[<span class="nv">Minha imagem</span>]: <span class="sx">relative/urls/cool/image.jpg</span> <span class="nn">"se precisar de um título, está aqui"</span></code></pre>
|
||||
[Minha imagem]: relative/urls/cool/image.jpg "se precisar de um título, está aqui"
|
||||
```
|
||||
|
||||
## Miscelânea
|
||||
|
||||
|
||||
@ -45,7 +45,7 @@ Markdown является надмножеством HTML, поэтому люб
|
||||
HTML-элементов -->
|
||||
```
|
||||
|
||||
## Заголовки
|
||||
## Заголовки
|
||||
|
||||
HTML-элементы от <h1> до <h6> размечаются очень просто:
|
||||
текст, который должен стать заголовком, предваряется
|
||||
@ -110,7 +110,7 @@ __И этот тоже.__
|
||||
Для вставки принудительных переносов можно завершить абзац двумя дополнительными пробелами:
|
||||
|
||||
```md
|
||||
Эта строка завершается двумя пробелами (выделите, чтобы увидеть!).
|
||||
Эта строка завершается двумя пробелами (выделите, чтобы увидеть!).
|
||||
|
||||
Над этой строкой есть <br />!
|
||||
```
|
||||
@ -208,7 +208,7 @@ __И этот тоже.__
|
||||
|
||||
```md
|
||||
my_array.each do |item|
|
||||
puts item
|
||||
puts item
|
||||
end
|
||||
```
|
||||
|
||||
@ -223,12 +223,11 @@ __И этот тоже.__
|
||||
В Github Flavored Markdown для блоков кода можно использовать
|
||||
специальный синтаксис:
|
||||
|
||||
<pre>
|
||||
<code class="highlight">```ruby
|
||||
```ruby
|
||||
def foobar
|
||||
puts "Привет, мир!"
|
||||
puts "Привет, мир!"
|
||||
end
|
||||
```</code></pre>
|
||||
```
|
||||
|
||||
Во фрагменте, приведённом выше, отступ не требуется.
|
||||
Кроме того, Github подсветит синтаксис языка, указанного после \`\`\`
|
||||
@ -255,6 +254,7 @@ end
|
||||
```md
|
||||
[Ссылка!](http://test.com/)
|
||||
```
|
||||
|
||||
Также для ссылки можно указать всплывающую подсказку (`title`), используя
|
||||
кавычки внутри круглых скобок:
|
||||
|
||||
@ -269,11 +269,13 @@ end
|
||||
|
||||
Markdown также позволяет размечать ссылку в виде сноски:
|
||||
|
||||
<pre><code class="highlight">[<span class="nv">Щёлкните эту ссылку</span>][<span class="ss">link1</span>] для подробной информации!
|
||||
[<span class="nv">Также посмотрите эту ссылку,</span>][<span class="ss">foobar</span>] если хотите.
|
||||
```md
|
||||
[Щёлкните эту ссылку][link1] для подробной информации!
|
||||
[Также посмотрите эту ссылку,][foobar] если хотите.
|
||||
|
||||
[<span class="nv">link1</span>]: <span class="sx">http://test.com/</span> <span class="nn">"Круто!"</span>
|
||||
[<span class="nv">foobar</span>]: <span class="sx">http://foobar.biz/</span> <span class="nn">"Нормально!"</span></code></pre>
|
||||
[link1]: http://test.com/ "Круто!"
|
||||
[foobar]: http://foobar.biz/ "Нормально!"
|
||||
```
|
||||
|
||||
`Title` также может быть в одинарных кавычках или круглых скобках, а также
|
||||
отсутствовать вовсе. Ссылки на сноски могут быть в любом месте документа,
|
||||
@ -281,9 +283,11 @@ Markdown также позволяет размечать ссылку в вид
|
||||
|
||||
Существует также неявное именование, когда ссылка является идентификатором.
|
||||
|
||||
<pre><code class="highlight">[<span class="nv">Это</span>][] ссылка.
|
||||
```md
|
||||
[Это][] ссылка.
|
||||
|
||||
[<span class="nv">это</span>]: <span class="sx">http://thisisalink.com/</span></code></pre>
|
||||
[это]: http://thisisalink.com/
|
||||
```
|
||||
|
||||
Правда, эта возможность не очень распространена.
|
||||
|
||||
@ -294,11 +298,15 @@ Markdown также позволяет размечать ссылку в вид
|
||||
```md
|
||||
|
||||
```
|
||||
|
||||
Изображения тоже могут быть оформлены как сноски.
|
||||
|
||||
<pre><code class="highlight">![<span class="nv">Это альтернативный текст.</span>][<span class="ss">myimage</span>]
|
||||
```md
|
||||
![Это альтернативный текст.][myimage]
|
||||
|
||||
[myimage]: relative/urls/cool/image.jpg "Если нужна подсказка, её можно добавить"
|
||||
```
|
||||
|
||||
[<span class="nv">myimage</span>]: <span class="sx">relative/urls/cool/image.jpg</span> <span class="nn">"Если нужна подсказка, её можно добавить"</span></code></pre>
|
||||
## Разное
|
||||
### Автоссылки
|
||||
|
||||
@ -341,6 +349,7 @@ Markdown также позволяет размечать ссылку в вид
|
||||
| Выравнивание | Выравнивание | Выравнивание |
|
||||
| влево | по центру | вправо |
|
||||
```
|
||||
|
||||
Или более компактно
|
||||
|
||||
```md
|
||||
|
||||
@ -48,6 +48,7 @@ bằng cách thêm số lượng dấu thăng (#) đằng trước chuỗi cần
|
||||
##### Đây là đầu mục <h5>
|
||||
###### Đây là đầu mục <h6>
|
||||
```
|
||||
|
||||
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.
|
||||
|
||||
```md
|
||||
@ -79,6 +80,7 @@ Trong cài đặt Markdown để hiển thị file của GitHub,ta còn có gạ
|
||||
```md
|
||||
~~Đoạn văn bản này được gạch ngang.~~
|
||||
```
|
||||
|
||||
## Đoạn văn
|
||||
|
||||
Đ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
|
||||
@ -153,6 +155,7 @@ Ta không nhất thiết phải điền số thứ thự cho chỉ mục đúng
|
||||
1. Mục thứ hai
|
||||
1. Mục thứ ba
|
||||
```
|
||||
|
||||
(Sẽ hiển thị như ví dụ trước đó)
|
||||
|
||||
Ta còn có thể sử dụng danh sách con
|
||||
@ -189,7 +192,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)
|
||||
|
||||
```md
|
||||
my_array.each do |item|
|
||||
puts item
|
||||
puts item
|
||||
end
|
||||
```
|
||||
|
||||
@ -201,12 +204,13 @@ John didn't even know what the `go_to()` function did!
|
||||
|
||||
Trong Markdown của GitHub, ta còn có thêm cách để hiển thị code:
|
||||
|
||||
<pre>
|
||||
<code class="highlight">```ruby
|
||||
````md
|
||||
```ruby
|
||||
def foobar
|
||||
puts "Hello world!"
|
||||
puts "Hello world!"
|
||||
end
|
||||
```</code></pre>
|
||||
```
|
||||
````
|
||||
|
||||
The above text doesn't require indenting, plus GitHub will use syntax
|
||||
highlighting of the language you specify after the \`\`\`
|
||||
@ -231,11 +235,13 @@ Một trong những thứ tốt nhất khi làm việc với Markdown là khả
|
||||
```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
|
||||
|
||||
```md
|
||||
[Click me!](http://test.com/ "Link to Test.com")
|
||||
```
|
||||
|
||||
Đường dẫn tương đối cũng hoạt động.
|
||||
|
||||
```md
|
||||
@ -244,19 +250,23 @@ Ta còn có thể tạo tiêu đề cho liên kết sử dụng cặp ngoặc nh
|
||||
|
||||
Markdown còn hỗ trợ liên kết kiểu tham chiếu.
|
||||
|
||||
<pre><code class="highlight">[<span class="nv">Nhấn vào đây</span>][<span class="ss">link1</span>] để xem thêm!
|
||||
[<span class="nv">Ngoài ra nhấn vào đây</span>][<span class="ss">foobar</span>] nếu bạn muốn xem qua.
|
||||
```md
|
||||
[Nhấn vào đây][link1] để xem thêm!
|
||||
[Ngoài ra nhấn vào đây][foobar] nếu bạn muốn xem qua.
|
||||
|
||||
[<span class="nv">link1</span>]: <span class="sx">http://test.com/</span> <span class="nn">"Tuyệt!"</span>
|
||||
[<span class="nv">foobar</span>]: <span class="sx">http://foobar.biz/</span> <span class="nn">"Tốt!"</span></code></pre>
|
||||
[link1]: http://test.com/ "Tuyệt!"
|
||||
[foobar]: http://foobar.biz/ "Tốt!"
|
||||
```
|
||||
|
||||
Tiêu đề có thể được đóng trong dấu nháy hay ngoặc đơn, hoặc có thể được bỏ qua. Tham chiếu có thể được đặt bất kì đâu trong văn bản và ID của tham chiếu có thể là bất kì gì miễn là nó độc nhất.
|
||||
|
||||
Ngoài ra còn có kiểu đặt tên ngầm cho phép ta sử dụng đường dẫn làm ID.
|
||||
|
||||
<pre><code class="highlight">[<span class="nv">This</span>][] is a link.
|
||||
```md
|
||||
[This][] is a link.
|
||||
|
||||
[<span class="nv">this</span>]: <span class="sx">http://thisisalink.com/</span></code></pre>
|
||||
[this]: http://thisisalink.com/
|
||||
```
|
||||
|
||||
Nhưng nó không được sử dụng rộng rãi.
|
||||
|
||||
@ -270,9 +280,11 @@ Hiển thị ảnh tương tự như liên kết nhưng có thêm dấu chấm t
|
||||
|
||||
Và kiểu tham chiếu cũng hoạt động như vậy.
|
||||
|
||||
<pre><code class="highlight">![<span class="nv">Đây là thuộc tính alt.</span>][<span class="ss">myimage</span>]
|
||||
```md
|
||||
![Đây là thuộc tính alt.][myimage]
|
||||
|
||||
[<span class="nv">myimage</span>]: <span class="sx">relative/urls/cool/image.jpg</span> <span class="nn">"Đây là tiêu đề"</span></code></pre>
|
||||
[myimage]: relative/urls/cool/image.jpg "Đây là tiêu đề"
|
||||
```
|
||||
|
||||
## Khác
|
||||
|
||||
@ -303,6 +315,7 @@ Trong Markdown của Github, ta có thể sử dụng thẻ `<kbd>` để thay c
|
||||
Máy treo? Thử bấm tổ hợp
|
||||
<kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd>
|
||||
```
|
||||
|
||||
### Bảng biểu
|
||||
|
||||
Bảng biểu được hỗ trợ trên Markdown của GitHub, Jira, Trello, v.v và khá khó viết:
|
||||
@ -313,6 +326,7 @@ Bảng biểu được hỗ trợ trên Markdown của GitHub, Jira, Trello, v.v
|
||||
| Căn trái | Căn giữa | Căn phải |
|
||||
| blah | blah | blah |
|
||||
```
|
||||
|
||||
Hoặc có thể sử dụng kết quả dưới đây
|
||||
|
||||
```md
|
||||
|
||||
@ -147,7 +147,6 @@ GitHub 也支持 Markdown，在 GitHub 的 Markdown 解析器中，我们可以
|
||||
- 项目
|
||||
- 项目
|
||||
- 最后一个项目
|
||||
|
||||
```
|
||||
|
||||
有序序列可由数字加上点 `.` 来实现
|
||||
@ -188,6 +187,7 @@ GitHub 也支持 Markdown，在 GitHub 的 Markdown 解析器中，我们可以
|
||||
下面这个选择框将会是选中状态
|
||||
- [x] 这个任务已经完成
|
||||
```
|
||||
|
||||
- [ ] 你看完了这个任务（注：此选择框是无法直接更改的，即禁用状态。）
|
||||
|
||||
## 代码块
|
||||
@ -204,7 +204,7 @@ GitHub 也支持 Markdown，在 GitHub 的 Markdown 解析器中，我们可以
|
||||
|
||||
```md
|
||||
my_array.each do |item|
|
||||
puts item
|
||||
puts item
|
||||
end
|
||||
```
|
||||
|
||||
@ -216,12 +216,13 @@ John 甚至不知道 `go_to()` 函数是干嘛的!
|
||||
|
||||
在GitHub的 Markdown（GitHub Flavored Markdown）解析器中，你可以使用特殊的语法表示代码块
|
||||
|
||||
<pre>
|
||||
<code class="highlight">```ruby
|
||||
````md
|
||||
```ruby
|
||||
def foobar
|
||||
puts "Hello world!"
|
||||
puts "Hello world!"
|
||||
end
|
||||
```</code></pre>
|
||||
```
|
||||
````
|
||||
|
||||
以上代码不需要缩进，而且 GitHub 会根据\`\`\`后指定的语言来进行语法高亮显示
|
||||
|
||||
@ -246,7 +247,6 @@ Markdown 最棒的地方就是便捷的书写链接。把链接文字放在中
|
||||
|
||||
```md
|
||||
[点我点我!](http://test.com/)
|
||||
|
||||
```
|
||||
|
||||
你也可以在小括号内使用引号，为链接加上一个标题（title）
|
||||
@ -345,6 +345,7 @@ Markdown同样支持引用形式的链接
|
||||
| 我是左对齐 | 居个中 | 右对齐 |
|
||||
| 注意 | 冒 | 号 |
|
||||
```
|
||||
|
||||
好吧，强行对齐字符是很难的。但是，至少比下面这种写法好一点——
|
||||
|
||||
```md
|
||||
@ -352,6 +353,7 @@ Markdown同样支持引用形式的链接
|
||||
:-- | :-: | --:
|
||||
这真的太丑了 | 药不能 | 停！！！！
|
||||
```
|
||||
|
||||
真的是*看着令人头晕*
|
||||
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user