Skip to main content

Search OfficeIMO

Enter a topic, API type, or PowerShell command.

Documentation Search all OfficeIMO/
Class

MarkdownWriteContext

OfficeIMO.Markdown

Namespace
OfficeIMO.Markdown
Assembly
OfficeIMO.Markdown
Source revision
0eef6a5756b9 with working tree changes
Modifiers
sealed

Context available while rendering a markdown document body back to Markdown text.

Inheritance

  • object
  • MarkdownWriteContext

Usage

Explore 4 API references to this type

This type appears in these public API surfaces even when no hand-authored example is attached directly to the page.

Methods

public IReadOnlyList<Entry> BuildTocEntries(int blockIndex, MarkdownTocOptions options, string? titleAnchor = null) #

Builds TOC-style heading entries relative to a specific top-level block index using the supplied TOC options.

Parameters

blockIndex int required
options OfficeIMO.Markdown.MarkdownTocOptions required
titleAnchor string? = null optional

Returns

IReadOnlyList<Entry>
public MarkdownSyntaxNode? FindSyntaxNode(object associatedObject) #

Finds the final syntax-tree node associated with a parsed model object, or null for builder-only documents.

Parameters

associatedObject object required
public int GetBlockIndex(IMarkdownBlock block) #

Returns the zero-based index of a top-level block in MarkdownWriteContext.Blocks, or -1 when the block is not present.

Parameters

block OfficeIMO.Markdown.IMarkdownBlock required

Returns

int
public string GetHeadingAnchor(IMarkdownBlock heading) #

Returns the resolved anchor id for a heading block within the current rendered document.

Parameters

heading OfficeIMO.Markdown.IMarkdownBlock required

Returns

string
public string? GetPrecedingHeadingAnchor(int blockIndex, MarkdownTocOptions options) #

Returns the anchor id of the nearest preceding heading according to the supplied TOC options, or null when no heading title should be associated with the specified block index.

Parameters

blockIndex int required
options OfficeIMO.Markdown.MarkdownTocOptions required

Returns

string?
public string RenderBlock(IMarkdownBlock block) #

Renders a block through the active Markdown writer dispatcher, including syntax-kind and type-targeted overrides. Custom container renderers should use this for child blocks instead of calling IMarkdownBlock.RenderMarkdown directly.

Parameters

block OfficeIMO.Markdown.IMarkdownBlock required

Returns

string
TryCreateOriginalSourceSlice 6 overloads
public bool TryCreateOriginalSourceSlice(object associatedObject, out MarkdownSourceSlice slice) #

Creates an original-input source slice for the final syntax node associated with a parsed model object.

Parameters

associatedObject object required
slice OfficeIMO.Markdown.MarkdownSourceSlice required

Returns

bool
public bool TryCreateOriginalSourceSlice(object associatedObject, out MarkdownSourceSlice slice, out MarkdownOriginalSourceSliceFailureReason failureReason) #

Creates an original-input source slice for the final syntax node associated with a parsed model object.

Parameters

associatedObject object required
slice OfficeIMO.Markdown.MarkdownSourceSlice required
failureReason OfficeIMO.Markdown.MarkdownOriginalSourceSliceFailureReason required

Returns

bool
public bool TryCreateOriginalSourceSlice(MarkdownSyntaxNode syntaxNode, out MarkdownSourceSlice slice) #

Creates an original-input source slice for the supplied final syntax node.

Parameters

syntaxNode OfficeIMO.Markdown.MarkdownSyntaxNode required
slice OfficeIMO.Markdown.MarkdownSourceSlice required

Returns

bool
public bool TryCreateOriginalSourceSlice(MarkdownSyntaxNode syntaxNode, out MarkdownSourceSlice slice, out MarkdownOriginalSourceSliceFailureReason failureReason) #

Creates an original-input source slice for the supplied final syntax node.

Parameters

syntaxNode OfficeIMO.Markdown.MarkdownSyntaxNode required
slice OfficeIMO.Markdown.MarkdownSourceSlice required
failureReason OfficeIMO.Markdown.MarkdownOriginalSourceSliceFailureReason required

Returns

bool
public bool TryCreateOriginalSourceSlice(MarkdownSourceSpan sourceSpan, out MarkdownSourceSlice slice) #

Creates an original-input source slice for a token or field source span captured during parsing.

Parameters

sourceSpan OfficeIMO.Markdown.MarkdownSourceSpan required
slice OfficeIMO.Markdown.MarkdownSourceSlice required

Returns

bool
public bool TryCreateOriginalSourceSlice(MarkdownSourceSpan sourceSpan, out MarkdownSourceSlice slice, out MarkdownOriginalSourceSliceFailureReason failureReason) #

Creates an original-input source slice for a token or field source span captured during parsing.

Parameters

sourceSpan OfficeIMO.Markdown.MarkdownSourceSpan required
slice OfficeIMO.Markdown.MarkdownSourceSlice required
failureReason OfficeIMO.Markdown.MarkdownOriginalSourceSliceFailureReason required

Returns

bool
TryCreateSourceSlice 3 overloads
public bool TryCreateSourceSlice(object associatedObject, out MarkdownSourceSlice slice) #

Creates a normalized source slice for the final syntax node associated with a parsed model object.

Parameters

associatedObject object required
slice OfficeIMO.Markdown.MarkdownSourceSlice required

Returns

bool
public bool TryCreateSourceSlice(MarkdownSyntaxNode syntaxNode, out MarkdownSourceSlice slice) #

Creates a normalized source slice for the supplied final syntax node.

Parameters

syntaxNode OfficeIMO.Markdown.MarkdownSyntaxNode required
slice OfficeIMO.Markdown.MarkdownSourceSlice required

Returns

bool
public bool TryCreateSourceSlice(MarkdownSourceSpan sourceSpan, out MarkdownSourceSlice slice) #

Creates a normalized source slice for a token or field source span captured during parsing.

Parameters

sourceSpan OfficeIMO.Markdown.MarkdownSourceSpan required
slice OfficeIMO.Markdown.MarkdownSourceSlice required

Returns

bool

Properties

public MarkdownDocument Document { get; } #

Document being serialized.

public IReadOnlyList<IMarkdownBlock> Blocks { get; } #

Top-level blocks being rendered for the current markdown document.

public MarkdownSaveOptions Options { get; } #

Active markdown writer options.

public CancellationToken CancellationToken { get; } #

Cancellation requested by the caller of the active Markdown serialization operation.