Use nu-highlight
for code blocks
#1719
Draft
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Work in progress. Adds a Shiki transformer which uses the
highlight.nu
script to highlight nushell code blocks usingnu-highlight
.Also adds the ability to add code before the true code block, for examples which require extra code to work:
Only the
str mycommand
line will show up in the final code block, but it will not be error highlighted since thestr mycommand
definition exists.The output of
nu-highlight
heavily depends on bold fonts for readability, so we should make sure all of the fonts listed in--code-font-family
support bold. Notably, on my machine the font fell back to Andale Mono, which did not have a bold face. I was able to get boldansi
highlighting working install consolas, which is a higher priority font in--code-font-family
and does have a bold face.Need to rebase this on #1718 assuming that gets merged.