Уценка со вкусом Github не применяется должным образом

Question

Я пишу некоторую документацию, используя файлы уценки. (*.md) Я использую плагин Markdown Editor версии 1.2.0.201501260515 для Eclipse. Я также использую плагин GFM Viewer версии 1.9.3 для просмотра md-файлов в Eclipse после их сохранения. Они выглядят хорошо там.

Я считаю, что разрывы строк внутри "блоков изолированного кода" не форматируются должным образом при просмотре в веб-браузере.

Например, вот фрагмент из файла MD

```
apply plugin: 'vt.platformwar.rpm'  
defaultTasks 'rpm'  
```

Тем не менее, вот как это завершается форматированием в Firefox после развертывания в корпоративной системе Atlassian, которая выглядит точно так же, как GitHub, но не является GitHub.

Я попытался просмотреть ту же страницу в IE, и она взорвалась с 500 Ошибка.

Я очень мало знаю об этой технологии, никогда не использовавшей ее раньше. Мой источник для того, как отформатировать это, был следующим: https://help.github.com/articles/creating-and-highlighting-code-blocks/

Почему это форматирование не правильно? И есть ли лучший способ сделать такое форматирование?

Answer 1

Тем не менее, вот как это завершается форматированием в Firefox после развертывания в корпоративной системе Atlassian, которая выглядит точно так же, как GitHub, но не является GitHub.

Atlassian, безусловно, не GitHub (на самом деле конкурент), и многие функции GitHub характерны для GitHub. На самом деле, блоки с огражденным кодом не являются стандартной функцией Markdown. Хотя они существовали до того, как GitHub принял их (хотя и в несколько ином виде), GitHub популяризировал эту функцию, и многие другие реализации Markdown с тех пор ее приняли. Однако для многих реализаций эта функция по умолчанию отключена. Если вы хотите использовать эту функцию, вам нужно определить, какую реализацию Markdown вы используете, и есть ли в ней поддержка огражденных кодовых блоков. Если это так, вам нужно будет включить функцию. Если нет, вам нужно будет переключиться на использование стандартных блоков кода Markdown, пометив блоки кода как минимум на 4 пробела или одну вкладку:

Some standard Markdown text followed by a code block:

    apply plugin: 'vt.platformwar.rpm'
    defaultTasks 'rpm'