Skip to content

Instantly share code, notes, and snippets.

@lucs
Last active May 1, 2023 00:26
Show Gist options
  • Save lucs/74f9e13a040a55600225ef81057a2a7d to your computer and use it in GitHub Desktop.
Save lucs/74f9e13a040a55600225ef81057a2a7d to your computer and use it in GitHub Desktop.
⌊raku --doc=Markdown ⋯⌉ produces some improper Markdown
=begin pod
⌊raku --doc=Markdown ⟨this file⟩⌉ produces
improper Markdown for the beginning here;
Indented
Baz
Indented
Foo
Indented
Jub
=end pod
# --------------------------------------------------------------------
=finish
Result:
- --------------------------------------------------------------------
⌊raku --doc=Markdown ⟨this file⟩⌉ produces improper Markdown for the beginning here;
Indented
Baz
Indented
Foo
Indented
Jub
- --------------------------------------------------------------------
Turns out this may actually be done by rakudo's Pod::To::Text.
After some experimentation, it appears that otherwise unmarked Pod text
having leading spaces on some lines may get reformated in hard to predict
ways, so I'll just wrap such sections with =begin code and =end code.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment