↓ Salti al ĉefa enhavo
La blogo de Stlara-F
  1. Artikoloj/

Markdown-konciso por skribado

·313 vortoj·2 min·
Retejaj Notoj Markdown Verkado
Stlara-F
Aŭtoro
Stlara-F
Lernnotoj, teknikaj resumoj kaj disaj pensoj.
Enhavotabelo

La Markdown, kiun vi bezonas por blogi, estas vere malmulte. La sekvaĵo kovras proksimume 95 % de la okazoj kaj estas rekte kopiebla.

Titoloj
#

La nombro de # montras la nivelon: # estas la unua nivelo, ## la dua. En la teksto komencu de la dua nivelo — la unua estas rezervita por la artikola titolo.

## Ĉi tio estas titolo de la dua nivelo
### Ĉi tio estas titolo de la tria nivelo
#### Ĉi tio estas titolo de la kvara nivelo

Emfazo
#

**grasa**
*kursiva*
~~forstrekita~~
`enlinia kodo`

Rezulto: grasa, kursiva, forstrekita, enlinia kodo.

Listoj
#

Senordaj listoj uzas - aŭ *, ordigitaj listoj uzas 1.:

- Unua ero
- Dua ero
  - Enigita ero (du spacoj antaŭe)

1. Unua paŝo
2. Dua paŝo

Ligiloj kaj bildoj
#

[ligila teksto](https://example.com)
![bilda priskribo](bilda adreso)

Bildojn plej bone metu en dosierujon samnoman kiel la artikolo kaj referencu per relativa vojo — tiel ili vojaĝas kune kun la artikolo.

Citaĵoj
#

> Ĉi tio estas citaĵo.
> Ĝi povas enhavi plurajn liniojn.

Kodblokoj
#

Ĉirkaŭu la kodon per tri malantaŭaj apostrofoj kaj skribu la lingvonomon tuj post ili — la kodo aŭtomate reliefiĝos kaj supre dekstre aperos kopibutono:

```python
def hello(name):
    print(f"Hello, {name}!")
```

Tabeloj
#

| Maldekstre | Centre | Dekstre |
| :--- | :---: | ---: |
| enhavo | enhavo | enhavo |

Divida linio
#

Tri streketoj sur propra linio faras dividan linion:

---

Du malgrandaj trukoj
#

Linrompo: unuopa linrompo ne validas en Markdown. Por devigi ĝin, metu du spacojn ĉe la fino de la linio — aŭ simple lasu malplenan linion kaj komencu novan alineon.

Specialaj signoj: se vi volas, ke * aŭ # aperu laŭlitere anstataŭ kiel sintakso, metu antaŭ ĝin malantaŭan oblikvon, skribante \*.

Memoru ĉi tion kaj sufiĉas. Dum skribado vi ne devas konscie pensi pri la sintakso; ĝi mem enmemoriĝos per praktiko.

写博客用到的 Markdown 语法其实很少。下面这些覆盖了 95% 的场景，可以直接复制去改。

标题
#

用 # 的数量表示层级，# 是一级标题，## 是二级。正文里从二级标题开始用，一级标题留给文章标题。

## 这是二级标题
### 这是三级标题
#### 这是四级标题

强调
#

**加粗**
*斜体*
~~删除线~~
`行内代码`

效果：加粗、斜体、删除线、行内代码。

列表
#

无序列表用 - 或 *，有序列表用 1.：

- 第一项
- 第二项
  - 嵌套项（前面空两格）

1. 第一步
2. 第二步

链接与图片
#

[链接文字](https://example.com)
![图片说明](图片地址)

图片建议放在和文章同名的文件夹里，用相对路径引用，这样文章的图片会跟着文章一起走。

引用
#

> 这是一段引用。
> 可以写多行。

代码块
#

用三个反引号包起来，并在开头写上语言名称，代码就会自动高亮，右上角还会出现复制按钮：

```python
def hello(name):
    print(f"Hello, {name}!")
```

表格
#

| 左对齐 | 居中 | 右对齐 |
| :--- | :---: | ---: |
| 内容 | 内容 | 内容 |

分隔线
#

三个短横线单独一行，就是一条分隔线：

---

两个小技巧
#

换行：Markdown 里单个换行不算换行，想强制换行就在行尾敲两个空格，或者直接空一行分段。

特殊符号：如果想让 * 或 # 原样显示而不被当成语法，在它前面加一个反斜杠，写成 \*。

记住这些基本就够用了。写作的时候不用刻意想语法，写顺了自然就记住了。

The Markdown you actually need for blogging is a small subset. What follows covers about 95% of real use, and you can copy it straight out.

Headings
#

The number of # marks the level: # is level one, ## is level two. In the body, start from level two — level one is reserved for the post title.

## This is a level-two heading
### This is a level-three heading
#### This is a level-four heading

Emphasis
#

**bold**
*italic*
~~strikethrough~~
`inline code`

Result: bold, italic, strikethrough, inline code.

Lists
#

Unordered lists use - or *; ordered lists use 1.:

- First item
- Second item
  - Nested item (indent two spaces)

1. First step
2. Second step

Links and images#

[link text](https://example.com)
![image caption](image-url)

Images are best kept in a folder named after the post and referenced with a relative path, so they travel together with the post.

Blockquotes
#

> This is a quote.
> It can span several lines.

Code blocks
#

Wrap the code in three backticks and name the language right after them — you get syntax highlighting and a copy button in the top-right corner:

```python
def hello(name):
    print(f"Hello, {name}!")
```

Tables
#

| Left | Center | Right |
| :--- | :---: | ---: |
| cell | cell | cell |

Horizontal rule
#

Three hyphens on their own line make a horizontal rule:

---

Two small tricks
#

Line breaks: a single newline in Markdown does not start a new line. To force one, put two spaces at the end of the line, or just leave a blank line to start a new paragraph.

Special characters: to show * or # literally instead of as syntax, put a backslash in front — write \*.

That is about all you need. You do not have to think about syntax while writing; it becomes second nature soon enough.

Для ведения блога Markdown нужен совсем небольшой. Всё, что ниже, покрывает примерно 95 % случаев, и это можно копировать и править под себя.

Заголовки
#

Уровень задаётся количеством #: # — первый уровень, ## — второй. В тексте начинайте со второго уровня — первый оставлен для заголовка статьи.

## Это заголовок второго уровня
### Это заголовок третьего уровня
#### Это заголовок четвёртого уровня

Выделение
#

**полужирный**
*курсив*
~~зачёркнутый~~
`строчный код`

Результат: полужирный, курсив, зачёркнутый, строчный код.

Списки
#

Маркированные списки используют - или *, нумерованные — 1.:

- Первый пункт
- Второй пункт
  - Вложенный пункт (с отступом в два пробела)

1. Первый шаг
2. Второй шаг

Ссылки и изображения
#

[текст ссылки](https://example.com)
![подпись к изображению](адрес изображения)

Изображения лучше хранить в папке с тем же именем, что и статья, и подключать по относительному пути — тогда они переезжают вместе со статьёй.

Цитаты
#

> Это цитата.
> Она может занимать несколько строк.

Блоки кода
#

Оберните код в три обратных апострофа и укажите сразу после них язык — код подсветится сам, а справа сверху появится кнопка копирования:

```python
def hello(name):
    print(f"Hello, {name}!")
```

Таблицы
#

| По левому краю | По центру | По правому краю |
| :--- | :---: | ---: |
| Текст | Текст | Текст |

Разделитель
#

Три дефиса на отдельной строке — это разделитель:

---

Две маленькие хитрости
#

Перенос строки: одиночный перенос в Markdown не считается переносом. Чтобы он был принудительным, поставьте два пробела в конце строки — или просто оставьте пустую строку и начните новый абзац.

Специальные символы: если нужно, чтобы * или # отображались буквально, а не как разметка, поставьте перед ними обратный слеш — напишите \*.

Этого в основном достаточно. Во время письма не нужно специально думать о разметке — с практикой она запоминается сама.

Le Markdown nécessaire pour tenir un blog est en réalité très réduit. Ce qui suit couvre environ 95 % des cas et peut se copier tel quel.

Titres
#

Le nombre de # indique le niveau : # est le niveau un, ## le niveau deux. Dans le corps du texte, partez du niveau deux — le niveau un est réservé au titre de l’article.

## Ceci est un titre de niveau deux
### Ceci est un titre de niveau trois
#### Ceci est un titre de niveau quatre

Mise en forme
#

**gras**
*italique*
~~barré~~
`code en ligne`

Rendu : gras, italique, barré, code en ligne.

Listes
#

Les listes à puces utilisent - ou *, les listes numérotées 1. :

- Premier élément
- Deuxième élément
  - Élément imbriqué (deux espaces devant)

1. Première étape
2. Deuxième étape

Liens et images
#

[texte du lien](https://example.com)
![légende de l'image](adresse de l'image)

Les images ont intérêt à être placées dans un dossier portant le nom de l’article et appelées par un chemin relatif : elles suivent ainsi l’article.

Citations
#

> Ceci est une citation.
> Elle peut tenir sur plusieurs lignes.

Blocs de code
#

Entourez le code de trois accents graves et indiquez le langage juste après — la coloration s’applique automatiquement et un bouton de copie apparaît en haut à droite :

```python
def hello(name):
    print(f"Hello, {name}!")
```

Tableaux
#

| À gauche | Centré | À droite |
| :--- | :---: | ---: |
| contenu | contenu | contenu |

Séparateur
#

Trois tirets sur une ligne à part forment un séparateur :

---

Deux petites astuces
#

Saut de ligne : un simple retour à la ligne ne compte pas en Markdown. Pour l’imposer, tapez deux espaces en fin de ligne — ou laissez simplement une ligne vide pour commencer un nouveau paragraphe.

Caractères spéciaux : pour afficher * ou # littéralement plutôt que comme balise, faites-les précéder d’une barre oblique inversée, en écrivant \*.

Voilà l’essentiel. Inutile de penser à la syntaxe en écrivant ; à force d’écrire, elle se retient d’elle-même.

Für das Bloggen braucht man erstaunlich wenig Markdown. Das Folgende deckt etwa 95 % der Fälle ab und lässt sich direkt kopieren und anpassen.

Überschriften
#

Die Anzahl der # gibt die Ebene an: # ist Ebene eins, ## ist Ebene zwei. Im Textkörper fängst du bei Ebene zwei an — Ebene eins ist dem Artikeltitel vorbehalten.

## Das ist eine Überschrift der Ebene zwei
### Das ist eine der Ebene drei
#### Das ist eine der Ebene vier

Hervorhebung
#

**fett**
*kursiv*
~~durchgestrichen~~
`Inline-Code`

Ergebnis: fett, kursiv, durchgestrichen, Inline-Code.

Listen
#

Aufzählungen nutzen - oder *, nummerierte Listen 1.:

- Erster Punkt
- Zweiter Punkt
  - Verschachtelter Punkt (zwei Leerzeichen davor)

1. Erster Schritt
2. Zweiter Schritt

Links und Bilder#

[Linktext](https://example.com)
![Bildbeschreibung](Bildadresse)

Bilder gehören am besten in einen Ordner mit demselben Namen wie der Artikel und werden mit relativem Pfad eingebunden — so wandern sie mit dem Artikel mit.

Zitate
#

> Das ist ein Zitat.
> Es darf mehrere Zeilen haben.

Codeblöcke
#

Umschließe den Code mit drei Backticks und schreibe die Sprache direkt dahinter — dann wird er automatisch hervorgehoben und oben rechts erscheint eine Kopierschaltfläche:

```python
def hello(name):
    print(f"Hello, {name}!")
```

Tabellen
#

| Links | Mitte | Rechts |
| :--- | :---: | ---: |
| Inhalt | Inhalt | Inhalt |

Trennlinie
#

Drei Bindestriche in einer eigenen Zeile ergeben eine Trennlinie:

---

Zwei kleine Kniffe
#

Zeilenumbruch: Ein einzelner Zeilenumbruch zählt in Markdown nicht als Umbruch. Erzwungen wird er mit zwei Leerzeichen am Zeilenende — oder du lässt einfach eine Leerzeile frei und beginnst einen neuen Absatz.

Sonderzeichen: Sollen * oder # wörtlich erscheinen und nicht als Syntax gelten, setzt du einen Backslash davor — also \*.

Das reicht im Wesentlichen aus. Beim Schreiben musst du nicht über die Syntax nachdenken; mit der Übung kommt sie von selbst.

Il Markdown che serve per tenere un blog è davvero poco. Quello che segue copre circa il 95% dei casi e si può copiare direttamente.

Titoli
#

Il numero di # indica il livello: # è il primo livello, ## il secondo. Nel corpo del testo parti dal secondo livello — il primo è riservato al titolo dell’articolo.

## Questo è un titolo di secondo livello
### Questo è un titolo di terzo livello
#### Questo è un titolo di quarto livello

Enfasi
#

**grassetto**
*corsivo*
~~barrato~~
`codice in linea`

Risultato: grassetto, corsivo, barrato, codice in linea.

Elenchi
#

Gli elenchi puntati usano - o *, quelli numerati 1.:

- Primo elemento
- Secondo elemento
  - Elemento annidato (due spazi davanti)

1. Primo passo
2. Secondo passo

Link e immagini#

[testo del link](https://example.com)
![descrizione dell'immagine](indirizzo dell'immagine)

Le immagini conviene tenerle in una cartella con lo stesso nome dell’articolo e richiamarle con un percorso relativo: così seguono l’articolo.

Citazioni
#

> Questa è una citazione.
> Può andare su più righe.

Blocchi di codice
#

Racchiudi il codice tra tre backtick e scrivi subito dopo il nome del linguaggio: la sintassi viene evidenziata da sola e in alto a destra compare un pulsante di copia.

```python
def hello(name):
    print(f"Hello, {name}!")
```

Tabelle
#

| A sinistra | Al centro | A destra |
| :--- | :---: | ---: |
| contenuto | contenuto | contenuto |

Linea di separazione
#

Tre trattini su una riga da soli formano una linea di separazione:

---

Due piccoli trucchi
#

A capo: in Markdown un singolo a capo non conta. Per imporlo, metti due spazi a fine riga — oppure lascia semplicemente una riga vuota e inizia un nuovo paragrafo.

Caratteri speciali: se vuoi che * o # compaiano alla lettera invece che come sintassi, mettici davanti una barra rovesciata, scrivendo \*.

Questo basta e avanza. Mentre scrivi non devi pensare alla sintassi: viene da sé.

ブログを書くのに必要な Markdown はごくわずかです。以下で 95% の場面をカバーできます。そのままコピーして使ってください。

見出し
#

# の数が階層を表します。# が見出し1、## が見出し2です。本文では見出し2から使い始めてください。見出し1は記事タイトル用に取ってあります。

## これは見出し2です
### これは見出し3です
#### これは見出し4です

強調
#

**太字**
*斜体*
~~取り消し線~~
`インラインコード`

結果：太字、斜体、取り消し線、インラインコード。

リスト
#

箇条書きは - か *、番号付きリストは 1. を使います：

- 1つ目の項目
- 2つ目の項目
  - 入れ子の項目（前に空白2つ）

1. 手順1
2. 手順2

リンクと画像
#

[リンクの文字](https://example.com)
![画像の説明](画像のアドレス)

画像は記事と同じ名前のフォルダに置き、相対パスで参照するのがおすすめです。そうすれば画像も記事と一緒に移動できます。

引用
#

> これは引用です。
> 複数行にわたって書けます。

コードブロック
#

バッククォート3つで囲み、その直後に言語名を書くと、コードが自動でハイライトされ、右上にコピーボタンが出ます：

```python
def hello(name):
    print(f"Hello, {name}!")
```

表
#

| 左寄せ | 中央 | 右寄せ |
| :--- | :---: | ---: |
| 内容 | 内容 | 内容 |

区切り線
#

ハイフン3つを単独の行に書くと区切り線になります：

---

小さなコツ2つ
#

改行：Markdown では単純な改行は改行として扱われません。強制的に改行したいときは行末に空白を2つ入れるか、いっそ空行を1行入れて段落を分けます。

特殊文字：* や # を記法としてではなくそのまま表示したいときは、その前にバックスラッシュを付けます。\* と書きます。

このあたりを覚えておけば十分です。書いているときに記法を意識する必要はありません。書いているうちに自然と身につきます。

O Markdown necessário para manter um blog é muito pouco. O que vem a seguir cobre cerca de 95% dos casos e pode ser copiado direto.

Títulos
#

A quantidade de # indica o nível: # é o nível um, ## é o nível dois. No corpo do texto, comece pelo nível dois — o nível um fica reservado para o título do post.

## Este é um título de nível dois
### Este é um título de nível três
#### Este é um título de nível quatro

Ênfase
#

**negrito**
*itálico*
~~riscado~~
`código em linha`

Resultado: negrito, itálico, riscado, código em linha.

Listas
#

Listas com marcadores usam - ou *; listas numeradas usam 1.:

- Primeiro item
- Segundo item
  - Item aninhado (dois espaços à frente)

1. Primeiro passo
2. Segundo passo

Links e imagens#

[texto do link](https://example.com)
![descrição da imagem](endereço da imagem)

Vale guardar as imagens numa pasta com o mesmo nome do post e referenciá-las por caminho relativo: assim elas viajam junto com o post.

Citações
#

> Isto é uma citação.
> Pode ocupar várias linhas.

Blocos de código
#

Envolva o código em três crases e escreva o nome da linguagem logo depois — a sintaxe é destacada automaticamente e um botão de copiar aparece no canto superior direito:

```python
def hello(name):
    print(f"Hello, {name}!")
```

Tabelas
#

| À esquerda | Centralizado | À direita |
| :--- | :---: | ---: |
| conteúdo | conteúdo | conteúdo |

Linha divisória
#

Três hífens sozinhos numa linha formam uma linha divisória:

---

Dois truques pequenos
#

Quebra de linha: no Markdown, uma quebra simples não conta. Para forçá-la, deixe dois espaços no fim da linha — ou simplesmente pule uma linha para começar outro parágrafo.

Caracteres especiais: para que * ou # apareçam literalmente em vez de virarem sintaxe, coloque uma barra invertida antes — escreva \*.

Com isso já dá para o gasto. Na hora de escrever não é preciso pensar na sintaxe; com a prática ela vem sozinha.

블로그를 쓰는 데 필요한 Markdown은 사실 얼마 되지 않습니다. 아래 내용이면 95%의 상황을 커버하고, 그대로 복사해서 쓸 수 있습니다.

제목
#

#의 개수가 계층을 나타냅니다. #은 1단계, ##은 2단계입니다. 본문에서는 2단계 제목부터 사용하세요. 1단계는 글 제목을 위해 남겨 둡니다.

## 이것은 2단계 제목입니다
### 이것은 3단계 제목입니다
#### 이것은 4단계 제목입니다

강조
#

**굵게**
*기울임*
~~취소선~~
`인라인 코드`

결과: 굵게, 기울임, 취소선, 인라인 코드.

목록
#

순서 없는 목록은 - 또는 *, 순서 있는 목록은 1.을 씁니다:

- 첫 번째 항목
- 두 번째 항목
  - 중첩 항목 (앞에 공백 두 칸)

1. 첫 번째 단계
2. 두 번째 단계

링크와 이미지
#

[링크 텍스트](https://example.com)
![이미지 설명](이미지 주소)

이미지는 글과 같은 이름의 폴더에 두고 상대 경로로 참조하는 편이 좋습니다. 그러면 이미지가 글과 함께 따라옵니다.

인용
#

> 이것은 인용문입니다.
> 여러 줄로 쓸 수 있습니다.

코드 블록
#

백틱 세 개로 감싸고 바로 뒤에 언어 이름을 적으면 코드가 자동으로 강조되고, 오른쪽 위에 복사 버튼이 나타납니다:

```python
def hello(name):
    print(f"Hello, {name}!")
```

표
#

| 왼쪽 정렬 | 가운데 | 오른쪽 정렬 |
| :--- | :---: | ---: |
| 내용 | 내용 | 내용 |

구분선
#

하이픈 세 개를 한 줄에 단독으로 쓰면 구분선이 됩니다:

---

두 가지 작은 요령
#

줄바꿈: Markdown에서는 단순한 줄바꿈이 줄바꿈으로 처리되지 않습니다. 강제로 줄을 바꾸려면 줄 끝에 공백 두 칸을 넣거나, 그냥 빈 줄을 한 줄 넣어 문단을 나눕니다.

특수 문자: *나 #을 문법이 아니라 그대로 표시하고 싶다면 앞에 백슬래시를 붙여 \*라고 씁니다.

이 정도면 충분합니다. 글을 쓸 때 문법을 일부러 생각할 필요는 없습니다. 쓰다 보면 자연스럽게 익혀집니다.