Markdown-chess is a VSCode extension for markdown files for chess.
It extends markdown with the chess functionality you've always wanted!
Using chess code blocks you can describe a chess position in a very similar way to Wikipedia's {{Chess diagram}} format
Chess pieces are notated by their letter below followed by l for light/white or d for dark/black:
k- kingq- queenr- rookb- bishopn- nightp- pawn
So the white king would be notated by kl.
You can add highlights to squares using symbols:
*Highlight Square (blue in default theme)!Highlight Attack (red in default theme)
You can add hints using these symbols:
.hint move optionoor.[piece]hint attack option
Combining these you can start to build a board with clear annotation both in markdown and when converted to svg format for preview: