Применение HTML в тексте

Сноски

Способ первый

В самом тексте

блаблабла <sup><a href="#sn10">10</a></sup>

В конце текста

<a name="sn10">10</a> это блаблабла неспроста

Способ второй и более привлекательный

После блока текста, на который надо сослаться <sup><a href="#sn11">11</a></sup>

В конце оформляется как нумерованный список:

<ol>
  <li id="sn11">Тут должен быть текст сноски</li>
</ol>

нумерация будет проставляться автоматически

Предупреждение

Обратите внимание - внутри HTML-тегов теги Markdown не распознаются.

Врезки (примечания, предупреждения и прочие)

Пока нашел решение оформлять в виде таблиц

Пример с выравниванием заголовка по центру:

<table border="1" width="100%" cellpadding="5">
  <tr>
    <td>
      <p align="center"><b>Настройка системного имени для глобальных Unique ID</b></p>
      <p>CDR состоит из уникального идентификатора и нескольких полей информации о вызове (включая исходный и целевой каналы, длину вызова, последнее выполненное приложение и т.д.). В кластеризованном наборе блоков Asterisk теоретически возможно дублирование уникальных идентификаторов, поскольку каждая система Asterisk учитывает только себя. Чтобы решить эту проблему, мы можем автоматически добавить системный идентификатор к передней части уникальных идентификаторов, добавив опцию в <i>etc/asterisk/asterisk.conf</i>. Для каждого из ваших блоков задайте идентификатор, добавив что-то вроде:</p>
<p><pre><code>
[options]
systemname=toronto
</code></pre></p>
    </td>
  </tr>
</table>

В блоках кода использовать связку <p><pre><code></code></pre></p> - в таком случае переносы учитываются и блоки кода получаются нормальными, в тексте допустимо <code></code>. Блоки кодов чуствительны к отступам - поэтому лучше не ставьте лишних отступов даже в угоду читаемости. Так же в блоках кодов заполняйте переносы тегами <br>.

Ещё один пример Примечания, но уже с изображением:

<table border="1" width="100%" cellpadding="5">
  <tr>
    <td>
    <p><img src="pics/note.png" height="100" align="left">Вы можете запустить Asterisk без модулей, загружаемых по умолчанию и загружать каждый нужный модуль вручную из консоли, но это не то, что вы хотели бы запустить в продакшен; это было бы полезно только в том случае, если бы вы настраивали производительность системы, в которой хотели убрать все, что не требуется вашим конкретным приложением Asterisk.</p>
    </td>
  </tr>
</table>

Обратите внимание - путь должен быть быз начального бэкслеша, т.е. pics/note.png. И пока Примечание не убирал.