magus v0.3.0 is out. See what's new
¶ View markdown source · ✎ Suggest an edit
1 min read

markdown

GitHub-Flavored Markdown to semantic HTML.

Naming convention: import the module under its bare name (import "markdown"), reach members with a backslash, and call methods in camelCase: markdown\someMethod.

Methods

toHtml

Render GitHub-Flavored Markdown to semantic HTML. Strips a leading YAML frontmatter block (a "---" fenced header at the top of the document) before rendering. Auto-IDs every heading so #fragment links resolve, and rewrites relative .md links (incl. README.md → index.html) to their generated .html equivalents. Raw HTML in the source is passed through (intended for trusted, first-party docs).

Signature: markdown\toHtml(source) → string · source

Parameter Type Optional Description
source string

Returns: string

frontmatter

Parse the leading YAML frontmatter block (a "---" fenced header at the top of the document) and return it as a JSON object string; decode with serialize.jsonDecode. Returns "{}" when no frontmatter is present.

Signature: markdown\frontmatter(source) → string · source

Parameter Type Optional Description
source string

Returns: string

stripFrontmatter

Return the Markdown body with any leading YAML frontmatter block removed (the source unchanged when none is present).

Signature: markdown\stripFrontmatter(source) → string · source

Parameter Type Optional Description
source string

Returns: string

auto-generatedmarkdownmodulestdlibmagusfile
Last updated (e0463131)
Earlier changes on this page (1)

Full history ↗ · Blame source ↗

Glossary

Magusfile

The magusfile.buzz that declares a project's targets (as export funs) and binds its spells. See targets.

Module

A magus stdlib namespace a magusfile imports for host capabilities: filesystem, exec, vcs, and more. See the module reference.

Conventions

This page uses none of the site's convention markers. The full set is on the conventions page.