13b - review nits: README code span, AGENTS.md §2 example, comments, block-directive link message

2026-09-16 23:28:31 +02:00
parent b792c946c5
commit 43292555cd
7 changed files with 12 additions and 11 deletions
@@ -20,7 +20,9 @@ export function readDirectiveMark(name: string, attributes: DirectiveAttributes,
 export function inlineMarkSpellingFault(name: string): ConvertFault | undefined {
  const spelling = markSpelling(name)
  if (spelling === undefined) return undefined
-  return { code: 'unsupported-node-shape', message: `${name} is spelled ${markdownForm(spelling) ?? `${directivePrefix}${name}[…]`}, never as a block directive` }
+  const directive = `${directivePrefix}${name}[…]`
+  const forms = spelling.kind === 'link' ? `[x](url) or ${directive}` : (markdownForm(spelling) ?? directive)
+  return { code: 'unsupported-node-shape', message: `${name} is spelled ${forms}, never as a block directive` }
 }

 function markdownForm(spelling: MarkSpelling): string | undefined {