https://www.duolingo.com/i.algurabi

Разметка MarkDown

i.algurabi
  • 15
  • 11
  • 11
  • 6
  • 4

Сам очень долго пытался разобраться в тонкостях разметки текста в комментариях Duo. Не нашёл единого места с описанием и решил сделать, вдруг окажется полезным кому-то.

UPD: Оказалось, что на форуме в разделе Немецкий на Русском такая статья уже есть. (см. комментарий от FieryCat )

UPD2: Шпаргалка по разметке MarkDown на Duolingo Wiki RU

Для начала, полное описание синтаксиса MarkDown (на английском) приведено на сайте автора John Gruber.


Заголовки

# Заголовок H1 - У Duo с этим типом заголовка какие-то проблемы

<h1>Заголовок H1 - У Duo с этим типом заголовка какие-то проблемы</h1>

## Заголовок H2

Заголовок H2

### Заголовок H3

Заголовок H3

#### Заголовок H4

Заголовок H4

##### Заголовок H5

Заголовок H5

###### Заголовок H6

Заголовок H6

Заголовки H1 и H2, можно еще задать нижним подчеркиванием:

Заголовок-H1 заданный подчеркиванием - У Duo с этим типом заголовка какие-то проблемы

======

<h1>Заголовок-H1 заданный подчеркиванием - У Duo с этим типом заголовка какие-то проблемы</h1>

Заголовок-H2 заданный подчеркиванием

------

Заголовок-H2 заданный подчеркиванием


Выделение

Курсив делается одинарными *звездочками* или _нижним подчеркиванием_.

Курсив делается звездочками или нижним подчеркиванием.

Выделение, так называемым жирным текстом, двойными **звездочками** или двойным __подчеркиванием__.

Выделение, так называемым жирным текстом, двойными звездочками или подчеркиванием.

А можно объединить **звездочки и _нижнее подчеркивание_**.

А можно объединить звездочки и нижнее подчеркивание.

Для перечёркнутого текста используйте двойные тильды. ~~Вычеркнем это .~~

Для перечёркнутого текста используйте двойные тильды. Вычеркнем это .


Списки

1. Первый элемент нумерованного списка

2. Следующий элемент

. . . . * Ненумерованный элемент подсписка.

1. Неважно, какую цифру вы поставите в начале. Главное, чтобы это была цифра.

. . . . 1. Нумерованный элемент подсписка

. . . . 1. И ещё один

4. Новый элемент.

. . . . Абзац выравненный по отступам с предыдущим элементом списка.

---

* Для ненумерованного списка, допустимо использование * (звёздочек)

- (-) минусов

+ или (+) плюсов

---

В примерах выше, пробелы указаны точками, так как иначе Duo их не отображает.

  1. Первый элемент нумерованного списка
  2. Следующий элемент
    • Ненумерованный элемент подсписка.
  3. Неважно, какую цифру вы поставите в начале. Главное, чтобы это была цифра.
    1. Нумерованный элемент подсписка
    2. И ещё один
  4. Новый элемент.

    Абзац выравненный по отступам с предыдущим элементом списка.


  • Для ненумерованного списка, допустимо использование * (звёздочек)
  • (-) минусов
  • или (+) плюсов

Ссылки

Ссылки можно задавть несколькими способами:

[Прямая сылка на внешний ресурс](https://github.com/i-algurabi/DuoVirtKeyboard)

Прямая сылка на внешний ресурс

[Относительная ссылка][Произвольный НечуСтвительный к рЕгистру текст]

Относительная ссылка

[Для относительных ссылок можно использовать цифры][99]

Для относительных ссылок можно использовать цифры

Или оставить её пустой используя [собственный текст описания ссылки]

Или оставить её пустой используя собственный текст описания ссылки

А ниже идёт набор относительных ссылок.

[произвольный нечуствительный к регистру текст]: https://www.mozilla.org

[99]: http://duolingo.com

[собственный текст описания ссылки]: https://github.com/i-algurabi/DuoVirtKeyboard

[1]: https://daringfireball.net/projects/markdown/basics


Изображения

В данном посте изображения не отображаются (извините за тафтологию), однако данная разметка работает в комментариях:

Прямая ссылка:

![текст замены](https://d35aaqx5ub95lt.cloudfront.net/images/owl-trophy-en.svg)

текст замены

Относительная ссылка:

![текст замены][logo]

текст замены

[logo]: https://duolingo-images.s3.amazonaws.com/avatars/247250809/0PeIW0Ja84/medium


Таблицы

Для выравнивания используйте двоеточия.

| Таблицы | Это | Круто |

| ------------------ |:-----------------:| -----:|

| столбец 3 выровнен | по правой стороне | $1600 |

| столбец 2 выровнен | по центру | $12 |

| А полоски зебры | просто аккуратны | $1 |

Таблицы Это Круто
столбец 3 выровнен по правой стороне $1600
столбец 2 выровнен по центру $12
А полоски зебры просто аккуратны $1

Внешние границы (|) опциональны, и выравнивать столбцы пробелами также необязательно. Внутри таблиц работают другие виды разметки.

Не такая | Красивая | Разметка

:--- |:---:| ---

*Но всё же* | `вполне красиво` | **отображаемая**

3 | 2 | 1

Не такая Красивая Разметка
Но всё же вполне красиво отображаемая
3 2 1

Цитирование

> Цитирирование удобно использовать для эмуляции ответа.

> Эта строка продолжает цитату.

Разобъем цитату.

> А это очень длинный текст с цитатой, который тем не менее будет корректно отображён. На всякий случай сделаем эту строчку подлинее, чтобы уж наверняка. Кстати при цитировании также можно использовать **MarkDown** разметку.

Цитирирование удобно использовать для эмуляции ответа. Эта строка продолжает цитату.

Разобъем цитату.

А это очень длинный текст с цитатой, который тем не менее будет корректно отображён. На всякий случай сделаем эту строчку подлинее, чтобы уж наверняка. Кстати при цитировании также можно использовать MarkDown разметку.


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

Можно отобразить горизонтальную линию тремя и более последовательными:

тире

---

звёздочками

****


и нижними подчёркиваниями

_____


8 месяцев назад

14 комментариев


https://www.duolingo.com/FieryCat
FieryCat
  • 25
  • 24
  • 13
  • 4
  • 1385

Две недели назад: https://www.duolingo.com/comment/26316484

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

8 месяцев назад

https://www.duolingo.com/LICA98
LICA98
  • 25
  • 25
  • 25
  • 25
  • 23
  • 21
  • 15
  • 13
  • 12
  • 11
  • 11
  • 11
  • 6
  • 6
  • 6
  • 5
  • 5
  • 5
  • 4
  • 4
  • 2
  • 2
  • 2
  • 2
  • 2
  • 2
  • 2
  • 2
  • 2
  • 2
  • 2
  • 2
  • 2
  • 2
  • 2
  • 606

error 404 выдаёт

8 месяцев назад

https://www.duolingo.com/FieryCat
FieryCat
  • 25
  • 24
  • 13
  • 4
  • 1385

Ага, он уже удалил. Там был такой же позор как и тут.

8 месяцев назад

https://www.duolingo.com/i.algurabi
i.algurabi
  • 15
  • 11
  • 11
  • 6
  • 4

Я не прошу Вас следовать моим советам. Предыдущий вариант странички не удалился по неизвестным мне причинам. Спасибо что дали ссылку, я его удалил.

К сожалению, особенности реализации обработки MarkDown синтаксиса на Duo отличаются от стандартных.

Поэтому страничка проверенная на GitHub'е отображалась здесь как Вы выразились:

пост выглядит как гумно

Пришлось несколько раз залить\удалить\отредактировать пост.

Если Вы считаете, что эта информация бесполезна, не пользуйтесь ею.

Если информация дублируется - поделитесь ссылкой.

8 месяцев назад

https://www.duolingo.com/FieryCat
FieryCat
  • 25
  • 24
  • 13
  • 4
  • 1385

Если информация дублируется - поделитесь ссылкой.

Старый пост, но вполне полезный: https://www.duolingo.com/comment/2700489. Если там чего-то нет, что тогда не работало а сейчас работает, то лучше написать об этом там, чем плодить повторяющиеся посты.

8 месяцев назад

https://www.duolingo.com/i.algurabi
i.algurabi
  • 15
  • 11
  • 11
  • 6
  • 4

Вот это уже конструктивный комментарий, спасибо. Добавил в начало поста.

К сожалению, мне не удалось ранее найти тот пост, возможно из-за того, что я не подписан на соответствующий форум.

Написать о том, что пост гумно может любой, а по-существу отвечает очень мало людей.

Вам же явно есть что сказать - зачем же Вы уподобляетесь "серой массе"

8 месяцев назад

https://www.duolingo.com/FieryCat
FieryCat
  • 25
  • 24
  • 13
  • 4
  • 1385

К сожалению, мне не удалось ранее найти тот пост, возможно из-за того, что я не подписан на соответствующий форум.

Поиск по форуму не зависит от подписок. Как по-вашему я этот пост для вас нашел?

Написать о том, что пост гумно может любой, а по-существу отвечает очень мало людей.

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

Вам же явно есть что сказать - зачем же Вы уподобляетесь "серой массе"

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

8 месяцев назад

https://www.duolingo.com/i.algurabi
i.algurabi
  • 15
  • 11
  • 11
  • 6
  • 4

Как по-вашему я этот пост для вас нашел?

Я благодарен Вам, что Вы нашли тот пост и добавил информацию об этом в начало своего поста. Точные причины по которым я не смог найти тот пост сам, мне неизвестны, я могу лишь предполагать.

Но, все же, предпочитаю отвечать на прямые вопросы а не угадывать их. Но один угадаю

Не надо пытаться угадывать чужие мысли, это такое же бессмысленное занятие, как писать комментарии пост гумно

найдите свой старый пост или комментарий и тренируйтесь в разметке именно на нем.

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

В комментариях разметка действует ровно так же, если ничего не изменилось.

Разметка в комментариях и в постах действует по-разному. Видмио что-то изменилось. Я так понимаю - это стандартная практика Duo, что-то изменять в поисках лучшего решения, иногда ломая хорошее :)

  • Разное количество пробелов для отступа.
  • Я видел, что изображения в постах присутствуют, но не смог найти корректный синтаксис для вставки ихображения в пост. В комментариях работает стандартный синтаксис MarkDown

На счет серой массы не понял, наверно не вижу связи.

Львиная доля комментариев пользователей ресурса не несёт в себе никакой полезной информации. Это "серая масса" , которая высказывается, для то чтобы высказаться. Так сказать - белый шум, который не несет по-факту никакой информации. Для такого рода реакции, когда нечего сказать по-существу, созданы кнопки голосования за пост\комментарий.

Но есть и другие. Те что дают развёпнутые объяснения, указывают на ошибки и дают советы по их исправлению.

С учётом Вашего опыта работы с данным ресурсом (я пользуюсь ресурсом меньше дней, чем Вы находитесь в ударном режиме), Ваши комментарии могли бы быть из второй категории и не умножать "белый шум". ИМХО.

8 месяцев назад

https://www.duolingo.com/FieryCat
FieryCat
  • 25
  • 24
  • 13
  • 4
  • 1385

Нашел свой старый пост, вставил картинку в тело поста. Никаких проблем абсолютно! Смотрите тут, потом удалю: https://www.duolingo.com/comment/20406151

added: Только что проверил на новом - тоже никаких проблем.

8 месяцев назад

https://www.duolingo.com/FieryCat
FieryCat
  • 25
  • 24
  • 13
  • 4
  • 1385

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

Мне надо было догадаться, что вы не знаете как протестировать работу Markdown на конкретном ресурсе? Догадаться что вы не знаете для чего разметка, о которой вы сами и пишите? Не умеете отслеживать/удалять свои же собственные посты? Не умеете пользоваться поиском на ресурсе? А не слишком ли много допущений? Серая масса, говорите? Пусть будет серая масса, но я и впредь хочу оставить за собой право говорить то, что думаю и делать заключения на основании фактов, которые вижу.

8 месяцев назад

https://www.duolingo.com/FieryCat
FieryCat
  • 25
  • 24
  • 13
  • 4
  • 1385

Откройте для себя экранирование спецсимволов, и тогда не придется писать так:
[Прямая сылка на внешний ресурс](сама_ссылка)

А достаточно будет так:
[Прямая сылка на внешний ресурс](сама_ссылка)

8 месяцев назад

https://www.duolingo.com/i.algurabi
i.algurabi
  • 15
  • 11
  • 11
  • 6
  • 4

[У меня раньше не срабатывало экранирование в стандарте MarkDown](может быть, потому что попал на очередное обновление Duo). Каюсь, в этом посте даже не пытался использовать его.

Но текст выделенный цветом тоже неплохо смотрится. Имхо.

8 месяцев назад

https://www.duolingo.com/qixyl
qixyl
  • 16
  • 14
  • 12
  • 7
  • 7
  • 6
  • 6
  • 6
  • 6
  • 5
  • 5
  • 4
  • 3
  • 3
  • 3
  • 2
  • 2
  • 836

https://www.duolingo.com/i.algurabi
i.algurabi
  • 15
  • 11
  • 11
  • 6
  • 4

Спасибо! Добавил ссылку в начало поста.

7 месяцев назад
Изучайте язык всего по 5 минут день. Абсолютно бесплатно.