Markdown guides

Practical, platform-aware guides to writing Markdown that renders the same on GitHub, dev.to, Obsidian and any CommonMark tool. Each one explains what differs and how to avoid surprises.

• Portable Markdown: Why It Renders Differently Everywhere

  Why the same Markdown looks different on GitHub, dev.to and Obsidian, and a checklist for making your writing render the same on every platform.

  Updated November 2, 2026

• CommonMark vs GitHub Flavored Markdown: What Differs

  A clear comparison of CommonMark and GitHub Flavored Markdown: tables, task lists, strikethrough, footnotes, autolinks and alerts, and when each one matters.

  Updated November 2, 2026

• Obsidian to GitHub Markdown: Wiki-links, Callouts & More

  How to share Obsidian notes outside Obsidian: convert wiki-links, highlights, callouts and embeds so they render on GitHub, dev.to and static sites.

  Updated November 2, 2026

• Writing Markdown for dev.to and Hashnode

  Tips for writing blog posts in Markdown that publish cleanly to dev.to and Hashnode: front matter, images, code blocks, raw HTML and what to check first.

  Updated November 2, 2026

• Markdown Line Breaks and Paragraphs Explained

  How line breaks work in Markdown: paragraphs, soft breaks and hard breaks, why trailing spaces are fragile, and which method renders the same everywhere.

  Updated November 2, 2026

• Markdown Images: Paths, Alt Text and Portability

  How to add images in Markdown so they show up everywhere: relative paths, hosted URLs, base64 data URIs, alt text and the mistakes that break previews.

  Updated November 2, 2026

• Math and Mermaid Diagrams in Markdown: Where They Work

  Where LaTeX math and Mermaid diagrams render in Markdown: GitHub and Obsidian support them, other platforms do not. How to write them and what to do instead.

  Updated November 2, 2026