Язык разметки Markdown.
Всем привет! Сегодня мы поговорим про язык разметки Markdown, узнаем его синтаксис и поймем, где его можно применять.
Этот язык не новый, появился он в 2004 году. Markdown - очень легкий язык разметки, который вы можете скомпилировать в html. Он прекрасно подходит для создания web контента, например, для написания статей на сайте.
Перейдем к синтаксису. Для начала вам нужно создать файл с расширением .md. Дальше мы будем компилировать этот язык в язык html. Вы можете найти компиляторы на просторах интернета.
Итак, сначала стоит отметить, что переносы текста игнорируются. К примеру, если вы напишите какой-то текст на разных строчках, то на выходе получите текст на одной. Если же вам нужно разбить текст на параграфы, то нужно вставить одну или более пустых строк. К примеру, вот так:
It's the first paragraph
It's the second paragraph
Если вам нужно сделать заголовок, т.е. то, что в html делается с помощью тега h1, то просто добавьте под текстом три или более символов =
It's the h1 heading
=======
Для создания заголовка h2 подчеркните текст линиями, состоящими из дефисов
It's the h2 heading
-------
Согласитесь, это не очень-то удобно, поэтому есть другой вариант оформления заголовков. Просто поставьте один символ # перед текстом, чтобы сделать его заголовком h1. Если вы поставите 2 символа #, то это будет заголовок h2, если 3, то h3, и так далее...
Если вам нужно оформить текст, как цитату, то поставьте перед ней символ <
< It's my quote
Чтобы сделать целый текст или только какую-то его часть курсивом, оберните участок текста символом *
Lorem *ipsum dolor sit* amet.
Чтобы сделать текст жирным, оберните его двумя *. Если вам нужно сделать текст сразу и жирным и курсивным, то оберните его тремя *.
Если вам по каким-то причинам не нравится использовать для этого здвездочки, то можете использовать знаки нижнего подчеркивания.
Если вам в тексте нужно использовать знак нижнего подчеркивания, звездочку или любой другой, который используется языком Markdown для оформления, то их нужно экранировать.
Lorem \_ipsum dolor sit\_ amet.
Перейдем к спискам. Для создания маркированных списков можно использовать звездочки в начале строки.
* item 1
* item 2
* item 3
* item 4
* item 5
Вместо звездочек также можно использовать знаки + и -.
Для создания нумерованных списков просто напишите любую цифру и точку, а затем нужный вам текст.
1. Item 1
1. Item 2
1. Item 3
1. Item 4
1. Item 5
Несмотря на то, что у нас везде в начале стоят цифры 1, список будет пронумерован правильно: 1, 2, 3, 4, 5
Для создания разделительных линий на странице вы можете использовать дефисы или звездочки на отдельных строчках
The first line
---
The second line
В результате вы получите такую же линию, как и при использовании тега hr
Для создания ссылок в Markdown вы должны обернуть текст в квадратные скобки, а затем написать, куда будет вести эта ссылка, в круглых скобках.
You can download it [here](http://yandex.ru/).
Изображения вставляются также, как и ссылки, только в начале вы должны поставить знак восклицания, затем в квадратных скобках указать текст, который будет выводиться, если изображение не будет загружено(т.е. это как атрибут alt в html), а затем указать путь до изображения в круглых скобках.
![It is the alt text](images/image.png)
Для того, чтобы обозначить кусок кода внутри параграфа, нужно обернуть его в обратные одинарные кавычки(апострофы)
Lorem ipsum dolor `<br>` sit amet.
Если вам нужно обозначить кусок кода не в параграфе, то просто вставьте его на страницу, а затем сделайте отступ слева в одну табуляцию или 4 пробела.
Lorem ipsum dolor sit amet.
var a = 7;
alert(a);
Lorem ipsum dolor sit amet.
Как вы могли заметить, текст на языке Markdown остается довольно читаемым по сравнению с html. Помимо этого его очень просто писать, поэтому его часто используют в разных онлайновых редакторах, например, в GitHub.
А на этом у меня все, спасибо за внимание!
-
- Михаил Русаков
Комментарии (2):
По-моему bbcode лучше подходит для обычных сайтов. В Wordpress например есть встроенное API для bbcode. У вас были материалы о том, как сделать такое же на чистом php? Я найти не могу. Если есть пример, покажите пожалуйста.
Ответить
Если вам нужно оформить текст, как цитату, то поставьте перед ней символ <<br> < It's my quote <br> А разве не этот символ '>' ?
Ответить
Для добавления комментариев надо войти в систему.
Если Вы ещё не зарегистрированы на сайте, то сначала зарегистрируйтесь.