magus v0.4.3 is out. See what's new
¶ View generated markdown
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

generatedreference/buzz/markdownmodulestdlibmagusfile
Last updated (29d8b3de)
Earlier changes on this page (6)

Full history ↗ · Blame source ↗

Glossary

Magusfile

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

Op

A single tool-native command a target composes (long form: operation); the middle of the work hierarchy (Spell to Op to Target). Op in full.

Module

A magus stdlib namespace a magusfile imports for host capabilities: filesystem, exec, vcs, and more. Module in full.

Buzz

The language magusfiles are written in (the .buzz engine). Buzz in full.

Conventions

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