Картинки рисования по клеточкам в тетради: Рисунки по клеточкам в тетради карандашом

Как написать Markdown в Jupyter Notebooks

Содержание

• Что такое Markdown?
• Каковы преимущества использования Markdown?
• Когда следует использовать Markdown в блокноте Jupyter?
• Как написать текст в Markdown
  • Жирный
  • Курсив
  • Жирный и курсив
• Как писать абзацы в Markdown
  • Пункты
  • Мягкие паузы
  • Жесткие перерывы
• Как сделать заголовки в Markdown
• Как добавить ссылки в Markdown
• Как добавить изображения в Markdown
• Как добавить цитаты в Markdown
• Как добавить списки в Markdown
  • Заказные списки
  • Ненумерованные списки

Что такое уценка?

Markdown — это язык. Однако это не язык программирования. Это то, что вы называете языком разметки . Язык разметки представляет собой способ аннотирования текстового документа для включения подсказок о том, как документ должен отображаться. Когда документ разметки обрабатывается (отображается), язык разметки не отображается. Вместо этого он используется для форматирования текста, и отображается только отформатированный текст.

Согласно Википедии, название markup происходит от «разметки» бумажных рукописей, что делают редакторы, предлагая исправления. Хорошо, это причудливое имя, но что это уценка? Скорее всего, вы уже использовали его (например, если вы когда-либо форматировали сообщения Slack), но, возможно, вы не знали, что он так называется. Markdown — это, по сути, способ написания форматированного текста.

Параметры форматирования, разрешенные Markdown, не отличаются разнообразием (например, вы не можете указать стиль или цвет шрифта), но они достаточно мощны, чтобы значительно повысить удобочитаемость текстового документа. Используя Markdown, вы можете быстро добавлять заголовки, ссылки, изображения, полужирный текст, курсив, абзацы и упорядоченные или неупорядоченные списки.

В этом руководстве я буду использовать Jupyter Notebook для демонстрации Markdown, однако обратите внимание, что Markdown не является специфичным для Jupyter. Многие другие службы и продукты используют его для упрощения форматирования текста.

• Краткое руководство: запуск нового ноутбука Jupyter
• Введение в программирование: как подготовить компьютер к запуску Python

ПРИМЕЧАНИЕ. В этом кратком руководстве по использованию блокнотов Jupyter я упоминаю, что Jupyter позволяет изменить тип ячейки, чтобы сделать ее ячейкой Markdown. Следуя приведенным ниже примерам, , пожалуйста, не забудьте изменить типы ячеек с кода на Markdown в блокноте Jupyter.

• Как писать и выполнять код в Jupyter Notebook

Каковы преимущества использования Markdown?

Конечно, вы можете форматировать текст в текстовом редакторе, так почему вы выбрали Markdown?

Прежде всего, в отличие от текстового формата, используемого многими редакторами, Markdown представляет собой обычный текст, что означает, что им очень легко обмениваться между компьютерами. Он не является проприетарным, поэтому любой может его использовать. Это также очень просто, но довольно мощно. Для написания Markdown требуется всего несколько символов и правил.

И последнее, но не менее важное: он совместим с Интернетом. Под этим я подразумеваю, что Markdown можно легко преобразовать в HTML, и поэтому его можно легко отображать в браузерах.

Собственно, именно это и происходит в ноутбуках Jupyter. Поскольку блокноты Jupyter отображаются в браузере, Markdown фактически преобразуется в HTML, и именно различные HTML-теги сообщают браузеру, как на самом деле отображать текст в формате Markdown. Хотя HTML выходит за рамки этого руководства, вот несколько примеров преобразования Markdown в HTML, которое происходит, когда Markdown отображается в блокноте Jupyter:

• Жирный текст становится обычным текстом внутри сильных тегов. Браузеры отображают текст внутри сильного текста жирным шрифтом.
• Изображения конвертируются в теги img . Браузеры умеют отображать эти теги как изображения.
Заголовки
• конвертируются в теги h2 , h3, и т.д. Браузеры умеют отображать эти теги в виде заголовков.

Когда следует использовать Markdown в блокноте Jupyter?

Уценка — это способ форматирования текста. По умолчанию ячейки блокнота Jupyter отформатированы для отображения кода, поэтому без Markdown нет простого способа включить пояснительный текст в блокноты. Конечно, вы всегда можете включить комментарии к коду, но их нельзя форматировать. Как насчет ссылок или изображений?

• Введение в программирование: как писать комментарии к коду Python

Блокноты Jupyter отлично подходят для презентации исследовательской работы. Собственно, отсюда они и берут свое начало — в представлении научной работы. Рассмотрим, например, приведенный ниже снимок экрана, представляющий небольшой раздел написанной мной записной книжки Jupyter, в которой представлена ​​концепция линейной регрессии в классическом машинном обучении.

Источник изображения: Markdown в блокноте Jupyter, Edlitera

Обратите внимание, как плавно чередуются ячейки Markdown и кода, что позволяет мне создать презентацию, включающую как пояснительный текст, так и исполняемый код. Хотя я мог бы использовать комментарии Python вместо ячеек Markdown, я утверждаю, что Markdown создает гораздо более приятный опыт для читателя.

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

Если вы убеждены и хотите изучить Markdown, давайте перейдем к руководству. Уценка очень проста — вам понадобится всего несколько минут, и вы станете в ней экспертом.

ПРИМЕЧАНИЕ. Ниже я показываю Markdown (что вам нужно ввести) фиолетовым цветом , а результат отображается прямо под ним.

Как написать текст в Markdown

Жирный шрифт

Чтобы выделить текст жирным шрифтом, просто окружите его звездочкой **. Например:

**это жирный текст**

это жирный текст

Курсив

Чтобы написать курсив, просто окружите текст символом _. Например:

_this is a italic text_

this is a italic text

Статья продолжается ниже Например:

**_это и полужирный шрифт, и курсив_**

это и полужирный шрифт, и курсив

Как писать абзацы в Markdown

Абзацы

Пожалуй, самая запутанная вещь в Markdown для начинающих. И вот почему: попробуйте ввести следующий текст в ячейку Markdown блокнота Jupyter:

Два домохозяйства, оба одинаковые по достоинству,
В прекрасной Вероне, где мы разыграем нашу сцену,
От древнего разрыва обиды к новому мятежу,
Где гражданская кровь делает гражданские руки нечисты.

Если вы напечатаете эти строки из пьесы Шекспира Ромео и Джульетта точно так, как они появляются выше, текст будет отображаться следующим образом:

Два дома, оба одинакового достоинства, В прекрасной Вероне, где мы разложили нашу сцену, Из древности Недовольство рвется к новому мятежу, Где гражданская кровь делает гражданские руки нечистыми.

Что случилось с разрывами строк? Ну, Markdown их проигнорировал. Вместо этого он предлагает два способа разрыва строк: мягкий разрыв и жесткий разрыв.

Мягкие разрывы

Мягкие разрывы достигаются добавлением двух пробелов после каждой строки. Вернемся к приведенному выше примеру и добавим два пробела после каждой строки.

ПРИМЕЧАНИЕ. Поскольку пробелы невидимы, ниже мы представляем каждый пробел символом + , но когда вы попробуете это в своем блокноте Jupyter, обязательно замените символы + пробелами.

Два дома, оба одинакового достоинства,++
В прекрасной Вероне, где мы устраиваем нашу сцену,++
От древней обиды к новому мятежу,++
Где гражданская кровь делает гражданские руки нечистыми.

Если вы набрали строки с двумя пробелами в конце , текст будет отображаться следующим образом:

Два дома, оба одинакового достоинства,
В прекрасной Вероне, где мы закладываем нашу сцену,
Из древности злопамятность прорывается к новому мятежу,
Где гражданская кровь делает гражданские руки нечистыми.

Разрывы

Разрывы используются для разделения абзацев. Вы можете добиться этого в Markdown, просто добавив пустую строку между абзацами. Например, рассмотрите следующий Markdown двух абзацев из 9 абзацев Оскара Уайльда. 0202 Картина Дориана Грея:

В центре комнаты, прижатый к вертикальному мольберту, стоял портрет в полный рост молодого человека необыкновенной красоты, а перед ним, на небольшом расстоянии, сидел сам художник Бэзил Холлуорд, внезапное исчезновение которого несколько лет назад вызвало в то время такое общественное волнение и породило столько странных догадок.

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

Обратите внимание на разрыв (пустую строку) между двумя абзацами. Если вы отобразите этот Markdown в блокноте Jupyter, он будет отображаться как:

В центре комнаты, прикрепленный к вертикальному мольберту, стоял портрет молодого человека необычайной красоты в полный рост, а перед ним Неподалеку сидел сам художник Бэзил Холлуорд, внезапное исчезновение которого несколько лет назад вызвало в то время такой общественный резонанс и породило столько странных догадок.

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

Это именно то, что вам нужно при написании абзацев.

Как сделать заголовки в Markdown

В Markdown есть 6 уровней заголовков. h2, h3, h4, h5, h5 и h6. h2 — самый большой, h6 — самый маленький. Чтобы написать заголовок, включите # перед текстом для заголовка h2, ## перед текстом для заголовка h3, ### перед текстом для заголовка h4 и так далее.

ПРИМЕЧАНИЕ: В блокнотах Jupyter необходимо оставить пробел между группой знаков # и текстом . Это не требуется в Markdown в целом, это скорее особенность блокнота Jupyter.

Например:

# это заголовок 1

это заголовок 1

## это заголовок 2

это заголовок 2 # это заголовок 2

это заголовок 3

#### это заголовок 4

это заголовок 4

##### это заголовок 5
59009 2 2 0195

ПРИМЕЧАНИЕ: В блокнотах Jupyter заголовок 5 (h5) отображается жирным шрифтом и курсивом.

###### это заголовок 6

это заголовок 6

ПРИМЕЧАНИЕ: В блокнотах Jupyter заголовок 5 (h5) и заголовок 6 (h5) идентичны.

Как добавлять ссылки в Markdown

Markdown позволяет легко вставлять ссылки в обычный текст. Для этого просто оберните текст ссылки в [ ] и оберните URL-адрес в ( ).

ПРИМЕЧАНИЕ: Не забудьте указать http:// или https:// для абсолютных ссылок, иначе ссылки будут считаться относительными.

[это ссылка на Edlitera](https://www.edlitera.com/)

это ссылка на Edlitera

Как добавить изображения в Markdown

Добавление изображений в блокнот Jupyter Ячейка Markdown очень похожа на добавление ссылок. Единственное отличие состоит в том, что перед квадратными скобками ставится восклицательный знак.


Источник изображения: Фото Кари Ши на Unsplash

ПРИМЕЧАНИЕ: При отображении изображения в уценке текст в квадратных скобках (например, [изображение кота, сидящего на стуле]) становится значением, присвоенным атрибуту alt изображения. Этот атрибут важен для доступности. Средства чтения с экрана используют значение этого атрибута для описания изображения людям, которым может быть трудно его увидеть. Поэтому, хотя вы можете оставить это поле пустым (и изображение все равно будет отображаться), рекомендуется выработать привычку добавлять его, включая описательный текст между квадратными скобками.

Как добавить цитаты в Markdown

Цитаты используются для привлечения внимания к цитатам из других источников. Они не так распространены в ноутбуках Jupyter, однако я представлю их здесь, если они вам понадобятся. Чтобы отобразить цитаты, просто добавьте знак «больше» (>) перед текстом, который вы хотите процитировать.

> Кто-то однажды сказал мне, что время — хищник, преследующий нас всю жизнь. Но я скорее верю, что время — это наш спутник, который сопровождает нас в путешествии и напоминает нам о том, что нужно ценить каждое мгновение, потому что оно больше никогда не повторится. То, что мы оставляем после себя, не так важно, как то, как мы жили. **Жан-Люк Пикард**

Кто-то однажды сказал мне, что время — хищник, преследующий нас всю жизнь. Но я скорее верю, что время — это наш спутник, который сопровождает нас в путешествии и напоминает нам о том, что нужно ценить каждое мгновение, потому что оно больше никогда не повторится. То, что мы оставляем после себя, не так важно, как то, как мы жили. Жан-Люк Пикард

ПРИМЕЧАНИЕ: В качестве примера я выделил текст жирным шрифтом в цитате. Это просто для того, чтобы показать, что вы можете комбинировать различные форматы Markdown для достижения именно того, что вам нужно.

Как добавлять списки в Markdown

У вас есть два типа списков: упорядоченные и неупорядоченные.

Нумерованные списки

В нумерованных списках каждый элемент списка начинается с номера. Что интересно в Markdown в блокнотах Jupyter, так это то, что вам не нужно включать числа самостоятельно. Вы можете начать каждый элемент списка с 1, например, и когда отображается Markdown, правильные числа будут заполнены.

Эта функция позволяет очень легко изменить порядок элементов без необходимости редактировать все эти номера!

Что нужно ввести:

Что будет отображено:

9 9002

Ненумерованные 0002 Ненумерованные списки — это списки, начинающиеся с маркеров.