Skip to content

Markdown

Parse frontmatter, convert to HTML, and generate table of contents.

3 modules

ModuleDescription
Analisar FrontmatterExtrair frontmatter YAML do conteúdo Markdown
Markdown para HTMLConverter texto Markdown para HTML
Gerar SumárioGerar um sumário a partir dos cabeçalhos do Markdown

Modules

Analisar Frontmatter

markdown.parse_frontmatter

Extrair frontmatter YAML do conteúdo Markdown

Parameters:

NameTypeRequiredDefaultDescription
textstringYes-Conteúdo Markdown com frontmatter

Output:

FieldTypeDescription
frontmatterobjectFrontmatter analisado como um dicionário
contentstringConteúdo Markdown sem frontmatter

Example: Parse YAML frontmatter

yaml
text: ---
title: Hello World
date: 2024-01-01
tags:
  - python
  - markdown
---

# Hello World

Content here.

Markdown para HTML

markdown.to_html

Converter texto Markdown para HTML

Parameters:

NameTypeRequiredDefaultDescription
textstringYes-Conteúdo Markdown para converter
extensionsarrayNo-Extensões Markdown para habilitar (usadas apenas com a biblioteca markdown)

Output:

FieldTypeDescription
htmlstringConteúdo HTML convertido
word_countnumberContagem de palavras do texto de entrada

Example: Convert markdown to HTML

yaml
text: # Hello

This is **bold** and *italic*.

Gerar Sumário

markdown.toc

Gerar um sumário a partir dos cabeçalhos do Markdown

Parameters:

NameTypeRequiredDefaultDescription
textstringYes-Conteúdo Markdown para extrair cabeçalhos
max_depthnumberNo3Profundidade máxima do cabeçalho a incluir (1-6)

Output:

FieldTypeDescription
tocarrayLista de cabeçalhos com nível, título e slug
toc_markdownstringSumário formatado em Markdown

Example: Generate TOC from markdown

yaml
text: # Introduction

## Getting Started

### Installation

### Configuration

## Usage

## API Reference
max_depth: 3

Released under the Apache 2.0 License.