Formata um texto para html seguindo algumas regras de formatação.

 $html = text2html ($text[, $filter_html_mode[, $alternative_marks]]);

Argumentos:

• $text é o conteúdo a ser formatado.
• $filter_html_mode: indica como as marcações HTML presentes no conteúdo deverão ser filtradas – este valor é repassado à função filter_html(), portanto, consulte a sua documentação.
• $alternative_marks é um array com marcações alternativas. Se for declarado como um array, cada item do array irá sobrescrever a marcação padrão correspondente.

Observações:

• Um novo parágrafo é sempre dado por uma linha em branco
• A aparência do texto formatado dependerá da folha de estilos do documento

Dependências:

• filter_html()

O que será reconhecido pelo formatador:

Cabeçalhos, do 1 ao 6:

 = Título nível 1 =

Título nível 1

 == Título nível 2 ==

Título nível 2

 === Título nível 3 ===

Título nível 3

 ==== Título nível 4 ====

Título nível 4

 ===== Título nível 5 =====

Título nível 5

 ====== Título nível 6 ======

Título nível 6

Listas:

 * Item
 * Item
 * Item

• IItem
• Item
• Item

 #Primeiro
 #Segundo
 #Terceiro

1. Primeiro
2. Segundo
3. Terceiro

 @Angelo
 @Bruno
 @Carla

1. Angelo
2. Bruno
3. Carla

As listas podem ter subitens:

 * Primeiro nível
 ** Segundo nível
 *** Terceiro nível

• Primeiro nível
  • Segundo nível
    • Terceiro nível

Ou combinando diversos tipos:

 * Item
 *# Primeiro
 *#@ Alfa

• Item
  1. Primeiro
     1. Alfa

Separador é feito com 5 hifens ou mais:

 -----

---

Texto pré-formatado:

  Iniciando a linha com um espaço em branco

 Iniciando a linha com um espaço em branco

Ou em grandes blocos que podem incluir linhas em branco:

Um

Texto

pré-formatado

Um

Texto

pré-formatado

A marcação [code] é bastante semelhante à [pre]. Também [script] e [style], com a diferença de que, se forem permitidos em $filter_html_mode = 2, serão convertidos em scripts e folhas de estilo ativas.

Marcações HTML utilizadas por padrão:

• ‘p_open’=>'<p>’, ‘p_close’=>'</p>’,
• ‘h1_open’=>'<h1>’,
• ‘h1_close’=>'</h1>’,
• ‘h2_open’=>'<h2>’,
• ‘h2_close’=>'</h2>’,
• ‘h3_open’=>'<h3>’,
• ‘h3_close’=>'</h3>’,
• ‘h4_open’=>'<h4>’,
• ‘h4_close’=>'</h4>’,
• ‘h5_open’=>'<h5>’,
• ‘h5_close’=>'</h5>’,
• ‘h6_open’=>'<h6>’,
• ‘h6_close’=>'</h6>’,
• ‘ul_open’=>'<ul>’,
• ‘ul_close’=>'</ul>’,
• ‘ol_open’=>'<ol>’,
• ‘ol_close’=>'</ol>’,
• ‘al_open’=>'<ol style=”list-style-type:lower-latin”>’,
• ‘al_close’=>'</ol>’,
• ‘li_open’=>'<li>’,
• ‘li_close’=>'</li>’,
• ‘pre_open’=>'<pre>’,
• ‘pre_close’=>'</pre>’,
• ‘code_open’=>'<code><pre>’,
• ‘code_close’=>'</pre></code>’,
• ‘style_open’=>'<style type=”text/css”>’,
• ‘style_close’=>'</style>’,
• ‘script_open’=>'<script type=”text/javascript”>’,
• ‘script_close’=>'</script>’,
• ‘hr’=>'<hr>’