Стиль: все блоки оформления

Содержание

Каждый блок — в своём разделе, чтобы можно было быстро посмотреть, как что выглядит.

Заголовки

H1 — заголовок страницы

H2 — раздел

H3 — подраздел

H4 — мельче

H5 — ещё мельче
H6 — самый мелкий

Параграф и инлайн-форматирование

Обычный текст. Жирный и курсив, жирный курсив, зачёркнутый. Можно вставить inline code. Сноска для затравки[1].

Верхний индекс: x2. Нижний индекс: H2O.

Горячие клавиши

Откройте файл в IDE: Cmd + Shift + O. Сохранить: Cmd + S. Закрыть вкладку: Ctrl + W.

Списки

Маркированный

  • Первый пункт
  • Второй пункт
    • Вложенный
    • Ещё вложенный
  • Третий пункт

Нумерованный

  1. Шаг один
  2. Шаг два
  3. Шаг три
    1. Подшаг
    2. Ещё подшаг

Чек-лист

  • Сделано
  • Не сделано

Definition list

Rust : системный язык с borrow checker, без GC

Zola : статический генератор сайтов на Rust

Tera : шаблонизатор, синтаксис близкий к Jinja2

Цитата

Лучший способ что-то понять — попробовать это объяснить.

— народная мудрость

GitHub-алерты

[!NOTE] Заметка — нейтральная справочная информация.

[!TIP] Совет — необязательное, но полезное замечание.

[!IMPORTANT] Важная информация, на которую стоит обратить внимание.

[!WARNING] Предупреждение о возможных проблемах.

[!CAUTION] Опасное действие или серьёзный риск.

Код

Inline

Переменная let x = 42; и функция String::from("hi") прямо в тексте.

Блок (Rust)

use std::io;

#[derive(Debug)]
enum AppError {
    Io(io::Error),
    NotFound,
}

impl From<io::Error> for AppError {
    fn from(e: io::Error) -> Self { AppError::Io(e) }
}

fn read_config(path: &str) -> Result<String, AppError> {
    let raw = std::fs::read_to_string(path)?;
    if raw.is_empty() { return Err(AppError::NotFound); }
    Ok(raw)
}

Блок (Python)

from dataclasses import dataclass

@dataclass
class User:
    id: int
    name: str

def greet(u: User) -> str:
    return f"Привет, {u.name}!"

Блок (Go)

package main

import "fmt"

func main() {
    for i := 0; i < 3; i++ {
        fmt.Println("hello", i)
    }
}

Блок (shell)

zola serve --open
task new -- my-post-slug

Блок (JSON)

{
  "title": "Мой блог",
  "tags": ["rust", "zola"],
  "published": true
}

Таблица

КатегорияЧто использую
ЯзыкиRust, Go, Python, TypeScript
Базы данныхPostgreSQL, Redis, SQLite
ОчередиRabbitMQ, NATS, Kafka
Сборка / задачиcargo, go-task, just

Изображение с подписью

Демо-картинка
Картинка вставляется шорткодом figure с подписью

Горизонтальный разделитель

Текст до разделителя.


Текст после разделителя. По CSS — звёзды * * * вместо линии.

Details / summary

Скрытый блок — нажмите, чтобы раскрыть

Здесь может быть длинный текст, дополнительные пояснения, спойлеры или примеры, которые не хочется показывать сразу.

fn hidden() {
    println!("сюрприз");
}

Сноска


  1. Так выглядит сноска внизу страницы. Перейдите по ссылке обратно к месту вставки.