Last active
May 1, 2023 00:26
-
-
Save lucs/74f9e13a040a55600225ef81057a2a7d to your computer and use it in GitHub Desktop.
⌊raku --doc=Markdown ⋯⌉ produces some improper Markdown
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
=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