markdownview

Markdown Guides

The complete syntax reference, plus plain-English answers to the problems people actually run into — why Markdown shows up as asterisks, why a file will not render, and what a .md file is in the first place.

Markdown is easy to write and surprisingly easy to get stuck on. It has no single specification — CommonMark defines the core, GitHub-Flavored Markdown adds tables and task lists, and individual editors layer on their own extensions — so a document that renders perfectly in one place can come out raw, half formatted, or missing a table somewhere else.

Most of what trips people up is not syntax they got wrong. It is a mismatch between where the Markdown was written and where it ended up: an AI assistant emits it, a chat window renders it, and then it gets pasted into an application that has no Markdown parser at all. These guides start from the symptom you are looking at and work back to the cause.

Everything here is written against what the tools actually do, with live examples you can copy, and each guide links to the converter that solves the problem it describes.

Reference

Look up how an element is written, with a live example beside it.

Fixes & explainers

Why something is not working, and what to do about it.