Patrik Svensson eeb3f967b6 Update emoji support
* Add constants for emojis
* Move emoji shortcode rendering to Markup
* Add documentation
* Add example
* Add tests
2020-09-18 16:11:51 +02:00

1.8 KiB

Title: Markup Order: 2

The class Markup allows you to output rich text to the console.

Syntax

Console markup uses a syntax inspired by bbcode. If you write the style (see Styles) in square brackets, e.g. [bold red], that style will apply until it is closed with a [/].

AnsiConsole.Render(new Markup("[bold yellow]Hello[/] [red]World![/]"));

The Markup class implements IRenderable which means that you can use this in tables, grids, and panels. Most classes that support rendering of IRenderable also have overloads for rendering rich text.

var table = new Table();
table.AddColumn(new TableColumn(new Markup("[yellow]Foo[/]")));
table.AddColumn(new TableColumn("[blue]Bar[/]"));

Convenience methods

There is also convenience methods on AnsiConsole that can be used to write markup text to the console without instantiating a new Markup instance.

AnsiConsole.Markup("[underline green]Hello[/] ");
AnsiConsole.MarkupLine("[bold]World[/]");

Escaping format characters

To output a [ you use [[, and to output a ] you use ]].

AnsiConsole.Markup("[[Hello]] "); // [Hello]
AnsiConsole.Markup("[red][[World]][/]"); // [World]

Setting background color

You can set the background color in markup by prefixing the color with on.

[bold yellow on blue]Hello[/]
[default on blue]World[/]

Rendering emojis

To output an emoji as part of markup, you can use emoji shortcodes.

AnsiConsole.MarkupLine("Hello :globe_showing_europe_africa:!");

For a list of emoji, see the Emojis appendix section.

Colors

For a list of colors, see the Colors appendix section.

Styles

For a list of styles, see the Styles appendix section.