Optional
value: stringPrivate
Readonly
#delegateUri that relative paths are resolved relative to.
If the baseUri
ends with /
, it is considered a directory and relative paths in the markdown are resolved relative to that directory:
const md = new vscode.MarkdownString(`[link](./file.js)`);
md.baseUri = vscode.Uri.file('/path/to/dir/');
// Here 'link' in the rendered markdown resolves to '/path/to/dir/file.js'
If the baseUri
is a file, relative paths in the markdown are resolved relative to the parent dir of that file:
const md = new vscode.MarkdownString(`[link](./file.js)`);
md.baseUri = vscode.Uri.file('/path/to/otherFile.js');
// Here 'link' in the rendered markdown resolves to '/path/to/file.js'
Uri that relative paths are resolved relative to.
If the baseUri
ends with /
, it is considered a directory and relative paths in the markdown are resolved relative to that directory:
const md = new vscode.MarkdownString(`[link](./file.js)`);
md.baseUri = vscode.Uri.file('/path/to/dir/');
// Here 'link' in the rendered markdown resolves to '/path/to/dir/file.js'
If the baseUri
is a file, relative paths in the markdown are resolved relative to the parent dir of that file:
const md = new vscode.MarkdownString(`[link](./file.js)`);
md.baseUri = vscode.Uri.file('/path/to/otherFile.js');
// Here 'link' in the rendered markdown resolves to '/path/to/file.js'
Indicates that this markdown string is from a trusted source. Only trusted
markdown supports links that execute commands, e.g. [Run it](command:myCommandId)
.
Defaults to false
(commands are disabled).
If this is an object, only the set of commands listed in enabledCommands
are allowed.
Indicates that this markdown string is from a trusted source. Only trusted
markdown supports links that execute commands, e.g. [Run it](command:myCommandId)
.
Defaults to false
(commands are disabled).
If this is an object, only the set of commands listed in enabledCommands
are allowed.
Indicates that this markdown string can contain raw html tags. Defaults to false
.
When supportHtml
is false, the markdown renderer will strip out any raw html tags
that appear in the markdown text. This means you can only use markdown syntax for rendering.
When supportHtml
is true, the markdown render will also allow a safe subset of html tags
and attributes to be rendered. See https://github.com/microsoft/vscode/blob/6d2920473c6f13759c978dd89104c4270a83422d/src/vs/base/browser/markdownRenderer.ts#L296
for a list of all supported tags and attributes.
Indicates that this markdown string can contain raw html tags. Defaults to false
.
When supportHtml
is false, the markdown renderer will strip out any raw html tags
that appear in the markdown text. This means you can only use markdown syntax for rendering.
When supportHtml
is true, the markdown render will also allow a safe subset of html tags
and attributes to be rendered. See https://github.com/microsoft/vscode/blob/6d2920473c6f13759c978dd89104c4270a83422d/src/vs/base/browser/markdownRenderer.ts#L296
for a list of all supported tags and attributes.
Indicates that this markdown string can contain ThemeIcons, e.g. $(zap)
.
Indicates that this markdown string can contain ThemeIcons, e.g. $(zap)
.
The markdown string.
The markdown string.
Appends the given string as codeblock using the provided language.
A code snippet.
Optional
language: stringAn optional languages.getLanguages language identifier.
Appends the given string 'as is' to this markdown string.
Markdown string.
Appends and escapes the given string to this markdown string.
Plain text.
Static
iswhether the thing is a markdown string implementation with helper methods.
The MarkdownString represents human readable text that supports formatting via the markdown syntax. Standard markdown is supported, also tables, but no embedded html.