Markdown Interpreter for Apache Zeppelin

Overview

Markdown is a plain text formatting syntax designed so that it can be converted to HTML. Apache Zeppelin uses flexmark, pegdown and markdown4j as markdown parsers.

In Zeppelin notebook, you can use %md in the beginning of a paragraph to invoke the Markdown interpreter and generate static html from Markdown plain text.

In Zeppelin, Markdown interpreter is enabled by default and uses the pegdown parser.

Example

The following example demonstrates the basic usage of Markdown in a Zeppelin notebook.

Mathematical expression

Markdown interpreter leverages %html display system internally. That means you can mix mathematical expressions with markdown syntax. For more information, please see Mathematical Expression section.

Configuration

Name	Default Value	Description
markdown.parser.type	flexmark	Markdown Parser Type. Available values: flexmark, pegdown, markdown4j.

Flexmark parser (Default Markdown Parser)

CommonMark/Markdown Java parser with source level AST.

flexmark parser provides YUML and Websequence extensions also.

Pegdown Parser

pegdown parser provides github flavored markdown. Although still one of the most popular Markdown parsing libraries for the JVM, pegdown has reached its end of life. The project is essentially unmaintained with tickets piling up and crucial bugs not being fixed.pegdown's parsing performance isn't great. But keep this parser for the backward compatibility.

Markdown4j Parser

Since pegdown parser is more accurate and provides much more markdown syntax markdown4j option might be removed later. But keep this parser for the backward compatibility.