Skip to content

Ecossistema de plugins Markdown

O verdadeiro poder do Markdown reside em sua extensibilidade. Através de plugins, você pode adicionar novos recursos, personalizar sintaxe e integrar Markdown com várias ferramentas e serviços.

Processadores Markdown populares

Marked.js

Analisador Markdown JavaScript rápido.

Instalação

bash
npm install marked

Uso básico

javascript
const marked = require('marked');
const html = marked.parse('# Hello World');

Markdown-it

Analisador Markdown plugável, rápido e fácil de estender.

Instalação

bash
npm install markdown-it

Com plugins

javascript
const md = require('markdown-it')();

md.use(require('markdown-it-emoji'));
md.use(require('markdown-it-footnote'));

const result = md.render('# Título :smile:');

Categorias de plugins essenciais

1. Extensões de sintaxe

GFM

bash
npm install remark-gfm

Emoji

bash
npm install markdown-it-emoji
javascript
const md = require('markdown-it')();
md.use(require('markdown-it-emoji'));
md.render('Olá :smile:');  // Olá 😄

2. Índice (TOC)

bash
npm install remark-toc

3. Destaque de código

bash
npm install highlight.js
javascript
const marked = require('marked');
const hljs = require('highlight.js');

marked.setOptions({
  highlight: function(code, lang) {
    if (lang && hljs.getLanguage(lang)) {
      return hljs.highlight(code, { language: lang }).value;
    }
    return code;
  }
});

Criar plugins personalizados

Plugin Markdown-it

javascript
function myPlugin(md) {
  md.renderer.rules.paragraph_open = function(tokens, idx, options, env, self) {
    tokens[idx].attrSet('class', 'custom-paragraph');
    return self.renderToken(tokens, idx, options);
  };
}

const md = require('markdown-it')();
md.use(myPlugin);

Conclusão

O ecossistema de plugins Markdown é muito rico e pode atender quase todas as necessidades. Escolher o processador e os plugins certos pode melhorar significativamente a funcionalidade do Markdown.

Recursos adicionais

Construído por www.markdownlang.com