Markdown — язык разметки для всех

Что такое Markdown?

Markdown — это лёгкий язык разметки, созданный Джоном Грубером в 2004 году. Текст остаётся читаемым даже без преобразования в HTML. Я студентка РУДН, учусь на прикладной информатике, и Markdown — мой незаменимый инструмент.

Markdown используют миллионы разработчиков по всему миру. На нём написаны README-файлы на GitHub, документация многих библиотек, посты в блогах и даже целые книги. Почему? Потому что он простой, быстрый и не требует специальных программ — достаточно любого текстового редактора.

Зачем нужен Markdown студенту?

Когда я только начала учиться на прикладной информатике, я оформляла все отчёты в Word. Это было мучительно: вечно съезжали картинки, плыли таблицы, а после сохранения в PDF половина форматирования ломалась. Потом я открыла для себя Markdown, и жизнь изменилась.

Теперь я пишу конспекты лекций в Obsidian — они выглядят красиво, ссылки работают как в википедии, а найти нужную тему можно за секунду. Лабораторные работы я тоже делаю в Markdown, а потом через Pandoc конвертирую в PDF — преподаватель получает аккуратный документ, а я не трачу часы на выравнивание картинок.

Базовый синтаксис

Вот основные элементы Markdown, которые нужно знать:

Заголовок 1 уровня — самый главный, обычно один на весь документ

Заголовок 2 уровня — разделы

Заголовок 3 уровня — подразделы

Заголовок 4 уровня — редко используется, но бывает нужно

Жирный текст — для важных вещей Курсивный текст — для акцентов Жирный курсив — для очень важных акцентов

• Маркированный список
• Второй элемент
  • Вложенный элемент (ставим два пробела перед дефисом)
  • Ещё один вложенный
• Третий элемент

1. Нумерованный список
2. Второй пункт
3. Вложенный нумерованный
4. Ещё один вложенный
5. Третий пункт

Ссылка на сайт — так делаются ссылки Ссылка с подсказкой

инлайн-код — для названий функций, переменных, команд

Цитата — можно так выделить важную мысль

Вторая строка цитаты

А это цитата внутри цитаты

Блоки кода

Для программиста блоки кода — самая важная фишка. В Markdown можно красиво оформлять код с подсветкой синтаксиса:

def hello():
    print("Hello, World!")

def fibonacci(n):
    if n <= 1:
        return n
    return fibonacci(n-1) + fibonacci(n-2)

for i in range(10):
    print(fibonacci(i))

# А это пример работы со списками
numbers = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
even_numbers = [x for x in numbers if x % 2 == 0]
print(f"Чётные числа: {even_numbers}")

class Student:
    def __init__(self, name, age, major):
        self.name = name
        self.age = age
        self.major = major
    
    def introduce(self):
        return f"Меня зовут {self.name}, мне {self.age}, учусь на {self.major}"

me = Student("Анна", 19, "прикладной информатике")
print(me.introduce())