Markdown转HTML

Markdown：不折腾就能写出格式漂亮的文档

Markdown让你用纯文本就能创建格式好看的文档。不用点菜单，不用跟Word搏斗。打个#就是标题，**双星号**就是加粗，加个-就是列表项，就这么简单。GitHub、Notion和大多数博客平台都用它。

Markdown和HTML的区别

Markdown最终会被转换成HTML来显示。比直接写HTML可读性强多了，特别适合写博客文章和技术文档。不过需要精细样式控制的场合，直接用HTML还是更合适。两者可以混用——大多数Markdown解析器都支持内联HTML。

Markdown速查表

基本语法简单得不能再简单了。#给你h1，##给你h2，一直到######。**加粗**和*斜体*跟看起来一样直观。无序列表用-或*开头，有序列表用1. 2. 3.。链接写成[点这里](https://example.com)，图片一样但前面加个!。代码用反引号包起来，代码块用三个反引号。表格稍微费点事——竖线(|)和横线(-)——但也能搞定。

Markdown无处不在

如果你用GitHub，你已经在写Markdown了——README、Issue和PR描述全是Markdown。Notion、Obsidian和Slack也理解Markdown快捷方式。静态网站生成器比如Jekyll、Hugo和Astro拿Markdown文件当内容源。技术文档、博客、wiki、内部知识库——Markdown已经成了技术圈默认的写作格式。就算你不是开发者，也值得学一下。

写好Markdown：大多数人容易犯的错

别跳标题级别——从#直接跳到###会搞乱文档结构，还会让屏幕阅读器犯迷糊。段落之间永远放一个空行（Markdown会忽略单个换行）。写代码块的时候标注语言（比如```javascript），这样会有语法高亮。长文档加个目录——读者会感谢你的。最后，发布之前一定要预览，因为Markdown在不同平台上渲染出来可能有微妙的差别。