Markdown документация, база знаний

Разработчикам

Библиотека преобразования Markdown

Для разбора markdown текста и формирвоания из него готового html, испольузется модифицированная версия библиотеки https://github.com/cebe/markdown под работу с сайтами на битркиса в кодировке UTF-8 или windows-1251.

Вы можете установить оригинальную библиотеку и обноdлять ее, она будет использована автоматически. Но работает она только с UTF-8.

Использвоания вне компонентов

Если стоит задача преобразовать маркдоун текст в html в произвольном месте, то можно воспользвоаться методами модуля.

\Bitrix\Main\Loader::includeModule('bxmaker.mdbase');
$markdownText = '# заголовок h1';
$html = \Bxmaker\Mdbase\Manager::getInstance()->getParser()->parse($markdownText);
echo $html;

Вывод редактора

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

$value = '# Заголовок';
$field = 'TEXT';

if(\Bitrix\Main\Loader::includeModule('bxmaker.mdbase'))
{
    \Bxmaker\Mdbase\Manager::getInstance()->showEditor($field, htmlspecialcharsback($value));
}
else
{
?>
<textarea cols="60" rows="20" name="<?=$field;?>" style="width:100%">
    <? echo $value ?>
</textarea>
<?
}