The Markdown output when running p6doc --doc=Markdown sample-code.p6 > ...

current-output.md

sub happy-birthday

sub happy-birthday(
    Str $name,
    Int $age
) returns Mu

Say Happy Birthday to a person.

class Mu $

Person's name

class Mu $

Person's age

sub greet

sub greet(
    Str $name,
    Str $greeting = "Hello"
) returns Mu

Greet a person.

class Mu $

Person's name

class Mu $

Greeting

expected-output.md

sub happy-birthday

sub happy-birthday(
    Str $name,
    Int $age
) returns Mu

Say Happy Birthday to a person.

class Str $name

Person's name

class Int $age

Person's age

sub greet

sub greet(
    Str $name,
    Str $greeting = "Hello"
) returns Mu

Greet a person.

class Str $name

Person's name

class Str $greeting = "Hello"

Greeting

sample-code.p6

#| Say Happy Birthday to a person.
sub happy-birthday(
    Str $name, #= Person's name
    Int $age   #= Person's age
) {
    say "Happy {$age}th Birthday $name!";
}

#| Greet a person.
sub greet(
    Str $name,               #= Person's name
    Str $greeting = 'Hello'  #= Greeting
) {
    say "{$greeting.tc}, $name!";
}