parser

type AutoLink ¶ added in v0.3.0

type AutoLink struct {
	BaseNode
	URL    string
	IsBare bool
	IsMail bool
}

AutoLink is <url> or a GFM bare-URL autolink.

type BaseNode ¶ added in v0.3.0

type BaseNode struct {
	NKind    NodeKind
	Start    int
	End      int
	TokCount int
	Kids     []Node
}

BaseNode holds fields common to every node and is embedded in each concrete type. Its exported fields let constructors populate state without per-type setters.

func (b *BaseNode) Children() []Node

func (b *BaseNode) Kind() NodeKind

func (b *BaseNode) LineEnd() int

func (b *BaseNode) LineStart() int

func (b *BaseNode) Tokens() int

type Blockquote ¶ added in v0.3.0

type Blockquote struct {
	BaseNode
}

Blockquote is a > quoted block, possibly nested.

type Callout ¶ added in v0.3.0

type Callout struct {
	BaseNode
	Variant CalloutKind
}

Callout is a GFM alert (> [!NOTE] / [!TIP] / [!IMPORTANT] / [!WARNING] / [!CAUTION]).

type CalloutKind ¶ added in v0.3.0

type CalloutKind string

CalloutKind identifies the variant of a GFM alert (> [!NOTE] etc).

const (
	CalloutNote      CalloutKind = "note"
	CalloutTip       CalloutKind = "tip"
	CalloutImportant CalloutKind = "important"
	CalloutWarning   CalloutKind = "warning"
	CalloutCaution   CalloutKind = "caution"
)

type CodeBlock ¶ added in v0.3.0

type CodeBlock struct {
	BaseNode
	Language string
	Info     string
	Fenced   bool
	Code     string
}

CodeBlock is a fenced or indented code block.

type CommitRef ¶ added in v0.3.0

type CommitRef struct {
	BaseNode
	SHA string
}

CommitRef is a SHA autolink (GFM).

type ContentSummary ¶ added in v0.3.0

type ContentSummary struct {
	Callouts     int
	Tables       int
	CodeBlocks   int
	MathBlocks   int
	HTMLBlocks   int
	Footnotes    int
	DefLists     int
	LinkRefDefs  int
	Tasks        int
	TasksChecked int
	WikiLinks    int
	WikiEmbeds   int
	Mentions     int
	IssueRefs    int
	CommitRefs   int
	Emojis       int
}

ContentSummary is an at-a-glance inventory of notable constructs across an entire Document. Used by the renderer to draw the file header.

type Definition ¶ added in v0.3.0

type Definition struct {
	BaseNode
}

Definition is a single definition for a term.

type DefinitionList ¶ added in v0.3.0

type DefinitionList struct {
	BaseNode
}

DefinitionList is a Pandoc-style definition list.

type DefinitionTerm ¶ added in v0.3.0

type DefinitionTerm struct {
	BaseNode
	Term string
}

DefinitionTerm is the term being defined.

type Delete ¶ added in v0.3.0

type Delete struct {
	BaseNode
}

Delete is ~~text~~ (GFM strikethrough).

type Document ¶

type Document struct {
	Filename    string
	TotalTokens int
	Sections    []*Section
	References  []Reference // Links to other .md files
	Nodes       []Node      // Typed AST (populated by the new parser)
}

Document represents a parsed markdown document.

The legacy Sections tree is heading-only and is what the renderer currently consumes. Nodes holds the richer typed AST produced by the new goldmark-based parser (frontmatter, tables, callouts, code blocks, Obsidian wiki links, etc.) once it lands. Both exist side-by-side during the migration so existing callers keep working.

func Parse(content string) *Document

func ParsePDF(filepath string) (*Document, error)

func ParseYAML(content string) (*Document, error)

func (d *Document) GetAllSections() []*Section

func (d *Document) GetSection(name string) *Section

func (d *Document) Summary() ContentSummary

type Emoji ¶ added in v0.3.0

type Emoji struct {
	BaseNode
	Name string
}

Emoji is :name: (GFM).

type Emphasis ¶ added in v0.3.0

type Emphasis struct {
	BaseNode
}

Emphasis is *text* or _text_.

type Entity ¶ added in v0.3.0

type Entity struct {
	BaseNode
	Raw     string
	Decoded string
}

Entity is an HTML entity (&copy;, &#169;, &#x2665;).

type FootnoteDef ¶ added in v0.3.0

type FootnoteDef struct {
	BaseNode
	ID string
}

FootnoteDef is a footnote definition ([^id]: content).

type FootnoteRef ¶ added in v0.3.0

type FootnoteRef struct {
	BaseNode
	ID string
}

FootnoteRef is [^id] in flowing text.

type Frontmatter ¶ added in v0.3.0

type Frontmatter struct {
	BaseNode
	Format FrontmatterFormat
	Raw    string
}

Frontmatter is a YAML/TOML/JSON header block at the top of a file.

type FrontmatterFormat ¶ added in v0.3.0

type FrontmatterFormat string

FrontmatterFormat is the serialization format of a frontmatter block.

const (
	FrontmatterYAML FrontmatterFormat = "yaml"
	FrontmatterTOML FrontmatterFormat = "toml"
	FrontmatterJSON FrontmatterFormat = "json"
)

type HTMLBlock ¶ added in v0.3.0

type HTMLBlock struct {
	BaseNode
	Raw string
}

HTMLBlock is a raw HTML block (includes <details>, <div>, comments).

type Heading ¶ added in v0.3.0

type Heading struct {
	BaseNode
	Level    int
	Title    string
	RawTitle string
	IsSetext bool
	ID       string
}

Heading is an ATX (# Title) or Setext (underline) heading.

type Image ¶ added in v0.3.0

type Image struct {
	BaseNode
	URL   string
	Alt   string
	Title string
	RefID string
}

Image is an inline or reference image.

type InlineCode ¶ added in v0.3.0

type InlineCode struct {
	BaseNode
	Code string
}

InlineCode is `text`.

type InlineHTML ¶ added in v0.3.0

type InlineHTML struct {
	BaseNode
	Raw string
}

InlineHTML is raw inline HTML like <kbd>.

type InlineMath ¶ added in v0.3.0

type InlineMath struct {
	BaseNode
	TeX string
}

InlineMath is $...$.

type IssueRef ¶ added in v0.3.0

type IssueRef struct {
	BaseNode
	Repo   string
	Number int
}

IssueRef is #123 / GH-123 / user/repo#123 (GFM).

type LineBreak ¶ added in v0.3.0

type LineBreak struct {
	BaseNode
	Hard bool
}

LineBreak is a hard (two-space / backslash) or soft line break.

type Link ¶ added in v0.3.0

type Link struct {
	BaseNode
	URL   string
	Title string
	Text  string
	RefID string
}

Link is an inline or reference link.

type LinkRefDef ¶ added in v0.3.0

type LinkRefDef struct {
	BaseNode
	Label string
	URL   string
	Title string
}

LinkRefDef is a reference link definition ([label]: url "title").

type List ¶ added in v0.3.0

type List struct {
	BaseNode
	Ordered bool
	Tight   bool
	Start   int
	Marker  rune
}

List is an ordered or unordered list.

type ListItem ¶ added in v0.3.0

type ListItem struct {
	BaseNode
}

ListItem is a regular item inside a list.

type MathBlock ¶ added in v0.3.0

type MathBlock struct {
	BaseNode
	TeX   string
	Fence string
}

MathBlock is a block-level math expression ($$...$$ or \[...\]).

type Mention ¶ added in v0.3.0

type Mention struct {
	BaseNode
	User string
}

Mention is @user (GFM).

type Node ¶ added in v0.3.0

type Node interface {
	Kind() NodeKind
	LineStart() int
	LineEnd() int
	Tokens() int
	Children() []Node
}

Node is the common interface every markdown construct implements. Concrete types embed BaseNode to satisfy it.

func FindByKind(root Node, kind NodeKind) []Node

type NodeKind ¶ added in v0.3.0

type NodeKind string

NodeKind enumerates every markdown construct docmap recognizes. The taxonomy covers CommonMark + GFM + Obsidian wiki links/embeds.

const (
	KindFrontmatter    NodeKind = "frontmatter"
	KindHeading        NodeKind = "heading"
	KindParagraph      NodeKind = "paragraph"
	KindBlockquote     NodeKind = "blockquote"
	KindCallout        NodeKind = "callout"
	KindList           NodeKind = "list"
	KindListItem       NodeKind = "list_item"
	KindTaskItem       NodeKind = "task_item"
	KindTable          NodeKind = "table"
	KindTableRow       NodeKind = "table_row"
	KindTableCell      NodeKind = "table_cell"
	KindCodeBlock      NodeKind = "code_block"
	KindMathBlock      NodeKind = "math_block"
	KindThematicBreak  NodeKind = "thematic_break"
	KindHTMLBlock      NodeKind = "html_block"
	KindDefinitionList NodeKind = "definition_list"
	KindDefTerm        NodeKind = "definition_term"
	KindDefinition     NodeKind = "definition"
	KindFootnoteDef    NodeKind = "footnote_def"
	KindLinkRefDef     NodeKind = "link_ref_def"

	KindText        NodeKind = "text"
	KindEmphasis    NodeKind = "emphasis"
	KindStrong      NodeKind = "strong"
	KindDelete      NodeKind = "delete"
	KindInlineCode  NodeKind = "inline_code"
	KindLink        NodeKind = "link"
	KindAutoLink    NodeKind = "autolink"
	KindImage       NodeKind = "image"
	KindWikiLink    NodeKind = "wiki_link"
	KindWikiEmbed   NodeKind = "wiki_embed"
	KindFootnoteRef NodeKind = "footnote_ref"
	KindMention     NodeKind = "mention"
	KindIssueRef    NodeKind = "issue_ref"
	KindCommitRef   NodeKind = "commit_ref"
	KindEmoji       NodeKind = "emoji"
	KindLineBreak   NodeKind = "line_break"
	KindEntity      NodeKind = "entity"
	KindInlineMath  NodeKind = "inline_math"
	KindInlineHTML  NodeKind = "inline_html"
)

type NotableStats ¶ added in v0.3.0

type NotableStats struct {
	Tasks        int
	TasksChecked int
	WikiLinks    int
	WikiEmbeds   int
	Mentions     int
	IssueRefs    int
	CommitRefs   int
	Emojis       int
}

NotableStats aggregates counts of constructs that would be noisy if listed per-instance under a section.

type Paragraph ¶ added in v0.3.0

type Paragraph struct {
	BaseNode
	Text string
	Raw  string
}

Paragraph is a block of flowing text. Text is the inline-rendered form (newlines collapsed); Raw preserves the original multi-line source so post-passes (math fences, etc.) can operate on real line boundaries.

type Reference ¶

type Reference struct {
	Text   string // Link text
	Target string // Target file path
	Line   int    // Line number where reference appears
}

Reference represents a link to another markdown file

type Section ¶

type Section struct {
	Level     int // 1 = #, 2 = ##, etc.
	Title     string
	Content   string   // raw content (excluding children)
	Tokens    int      // estimated tokens for this section
	KeyTerms  []string // extracted key concepts
	Children  []*Section
	Parent    *Section
	LineStart int
	LineEnd   int
	Notables  []Node
	Stats     NotableStats
}

Section represents a heading and the content that follows it up to the next same-or-higher heading.

Notables lists the discoverable block nodes inside this section that an agent might want to jump to directly — callouts, tables, code blocks, math blocks, HTML blocks, footnote definitions, definition lists. It is populated one-per-instance so the renderer can print each as its own line.

Stats aggregates counts of things that would be noisy per-instance (task list items, Obsidian wiki links, Obsidian embeds). They are rendered as a single summary line per section.

type Strong ¶ added in v0.3.0

type Strong struct {
	BaseNode
}

Strong is **text** or __text__.

type Table ¶ added in v0.3.0

type Table struct {
	BaseNode
	Headers []string
	Aligns  []TableAlign
}

Table is a GFM table.

type TableAlign ¶ added in v0.3.0

type TableAlign string

TableAlign specifies a column's alignment in a GFM table.

const (
	AlignNone   TableAlign = ""
	AlignLeft   TableAlign = "left"
	AlignCenter TableAlign = "center"
	AlignRight  TableAlign = "right"
)

type TableCell ¶ added in v0.3.0

type TableCell struct {
	BaseNode
	Align TableAlign
}

TableCell is one cell within a row.

type TableRow ¶ added in v0.3.0

type TableRow struct {
	BaseNode
	IsHeader bool
}

TableRow is a single row of a table.

type TaskItem ¶ added in v0.3.0

type TaskItem struct {
	BaseNode
	Checked bool
}

TaskItem is a GFM task list item ([ ] or [x]).

type Text ¶ added in v0.3.0

type Text struct {
	BaseNode
	Value string
}

Text is a plain run of characters.

type ThematicBreak ¶ added in v0.3.0

type ThematicBreak struct {
	BaseNode
}

ThematicBreak is --- / *** / ___.

type WikiEmbed ¶ added in v0.3.0

type WikiEmbed struct {
	BaseNode
	Target string
	Width  int
	Height int
}

WikiEmbed is ![[file]] / ![[file|200]] / ![[file|200x100]] (Obsidian).

type WikiLink ¶ added in v0.3.0

type WikiLink struct {
	BaseNode
	Target string
	Alias  string
	Anchor string
	Block  string
}

WikiLink is [[Page]] / [[Page|alias]] / [[Page#header]] / [[Page#^block]] (Obsidian).