d2

README

Goldmark D2

Goldmark D2 is a Goldmark extension providing diagram support through D2.

Usage

goldmark.New(
	goldmark.WithExtensions(&Extender{
		// Defaults when omitted
		Layout:  Ptr("dagre"), // "elk" also works
		ThemeID: Ptr(d2themescatalog.CoolClassics.ID),
		Sketch:	 Ptr(false),
	}),
).Convert(src, dst)

Example

The following diagram shows the important link between the letters X and Y: ```d2 x -> y ```
{Sketch: true} ```d2 dogs -> cats -> mice: chase replica 1 <-> replica 2 a -> b: To err is human, to moo bovine { source-arrowhead: 1 target-arrowhead: * { shape: diamond } } ```

Documentation

Index

• Variables
• func Ptr[T any](v T) *T
• type Block
  • func (n *Block) Dump(source []byte, level int)
  • func (n *Block) IsBlank(source []byte) bool
  • func (n *Block) Kind() ast.NodeKind
• type Extender
  • func (e *Extender) Extend(m goldmark.Markdown)
• type HTMLRenderer
  • func (r *HTMLRenderer) RegisterFuncs(reg renderer.NodeRendererFuncRegisterer)
  • func (r *HTMLRenderer) Render(w util.BufWriter, src []byte, node ast.Node, entering bool) (ast.WalkStatus, error)
• type Transformer
  • func (s *Transformer) Transform(doc *ast.Document, reader text.Reader, pctx parser.Context)

Variables

var KindBlock = ast.NewNodeKind("Block")

Functions

func Ptr

func Ptr[T any](v T) *T

Types

type Block

type Block struct {
	ast.BaseBlock
}

func (*Block) Dump

func (n *Block) Dump(source []byte, level int)

func (*Block) IsBlank

func (n *Block) IsBlank(source []byte) bool

func (*Block) Kind

func (n *Block) Kind() ast.NodeKind

type Extender

type Extender struct {
	Layout  *string `json:"layout,omitempty"`
	ThemeID *int64  `json:"theme_id,omitempty"`
	Sketch  *bool   `json:"sketch,omitempty"`
}

func (*Extender) Extend

func (e *Extender) Extend(m goldmark.Markdown)

type HTMLRenderer

type HTMLRenderer struct {
	Extender
}

func (*HTMLRenderer) RegisterFuncs

func (r *HTMLRenderer) RegisterFuncs(reg renderer.NodeRendererFuncRegisterer)

func (*HTMLRenderer) Render

func (r *HTMLRenderer) Render(
	w util.BufWriter,
	src []byte,
	node ast.Node,
	entering bool,
) (ast.WalkStatus, error)

type Transformer

type Transformer struct {
}

func (*Transformer) Transform

func (s *Transformer) Transform(doc *ast.Document, reader text.Reader, pctx parser.Context)