终端Markdown渲染

Install from source

After the git clone least one of these should work, hopefully. it's using the modern uv pip tool but is also backwards compatible to the pip3 install -r requirements.txt flow.

$ pipx install -e . $ pip install -e . $ uv pip install -e .

Explore the rest of DA`/50. Feel free to follow us, there's some exciting stuff coming.

Demo

Do this

$ ./streamdown/sd.py tests/*md

Colors are highly (and quickly) configurable for people who care a lot, or just a little.

Configuration

The location it's stored is platform specific and can be seen with the -h flag. If this file does not exist upon first run, it will be created with default values.

Here are the sections:

[style]

Defines the base Hue (H), Saturation (S), and Value (V) from which all other palette colors are derived. This can also be specified at runtime via command line arguments. See below!

The default values are at the beginning of the source.

• HSV: [ 0.0 - 1.0, 0.0 - 1.0, 0.0 - 1.0 ]
• Dark: Multipliers for background elements, code blocks.
• Grey: Multipliers for blockquote and thinkblock.
• Mid: Multipliers for inline code backgrounds, table headers.
• Symbol: Multipliers for list bullets, horizontal rules, links.
• Head: Multipliers for level 3 headers.
• Bright: Multipliers for level 2 headers.
• Margin (integer, default: 2): The left and right indent for the output.
• Width (integer, default: 0): Along with the Margin, Width specifies the base width of the content, which when set to 0, means use the terminal width. See #6 for more details
• PrettyPad (boolean, default: true): Uses a unicode vertical pad trick to add a half height background to code blocks. This makes copy/paste have artifacts. See #2. I like it on. But that's just me
• PrettyBroken (boolean, default: true): This will break the copy/paste assurance above. The output is much prettier, but it's also broken. So it's pretty broken. Works nicely with PrettyPad.
• ListIndent (integer, default: 2): This is the recursive indent for the list styles.
• Syntax (string, default native): This is the syntax highlighting theme which come via pygments.

Example:

[style]
PrettyPad = true
PrettyBroken = true
HSV = [0.7, 0.5, 0.5]
Dark = { H = 1.0, S = 1.2, V = 0.25 } # Make dark elements less saturated and darker
Symbol = { H = 1.0, S = 1.8, V = 1.8 } # Make symbols more vibrant

[features]

Controls optional features: Timeout (float, default: 0.1): controls the select timeout for streaming. This usually doesn't have to be modified. Network (boolean, default: true): controls whether network calls are made (such as for the rendering of remote images). See #29 Images (boolean, default: true): controls whether images are rendered or not. CodeSpaces (boolean, default: true): Enables detection of code blocks indented with 4 spaces. Set to false to disable this detection method (triple-backtick blocks still work). Clipboard (boolean, default: true): Enables copying the last code block encountered to the system clipboard using OSC 52 escape sequences upon exit. Set to false to disable. Logging (boolean, default: false): Enables logging to tmpdir (/tmp/sd) of the raw markdown for debugging and bug reporting. The logging uses an emoji as a record separator so the actual streaming delays can be simulated and replayed. If you use the filename based invocation, that is to say, sd <filename>, this type of logging is always off. * Savebrace (boolean, default: true): Saves the code blocks of a conversation to the append file $TMP/sd/$UID/savebrace so you can fzf or whatever you want through it. See how it's used in DAY50's sidechat.

Example:

[features]
CodeSpaces = false
Clipboard = false

Has a [Plugin](https://github.com/kristopolous/Streamdown/tree/main/streamdown/plugins) system to extend the parser and renderers.

For instance, here is the latex plugin doing math inside a table:

It is designed for AI and can be used to do parser based sophisticated pipelines and routing, cracking open various monolithic AI solutions to permit them to integrate. Think of it as output level routing at the semantic level.

You can also just use it like a normal person.