Markdown语法手册:易读易写的原则与HTML兼容

3星 · 超过75%的资源 需积分: 35 55 下载量 2 浏览量 更新于2024-09-09 收藏 510KB PDF 举报
"markdown手册" Markdown是一种轻量级的标记语言,设计用于使人们能更方便地书写含有格式的文本,同时保持文本的易读性。它的语法简洁明了,易于理解,深受程序员和非程序员的喜爱。Markdown的目标是实现“易读易写”,并且与HTML兼容,但并不打算替代HTML,而是作为书写时的格式化工具。 Markdown的基本语法包括: 1. **段落和换行**:连续的两行空行表示一个新的段落。单行内连续两个或多个空格或制表符会被视为一个换行,但在HTML输出中通常会被忽略,不会产生新的段落。 2. **标题**:使用#号来创建标题,#的数量对应于标题的层级,例如,`# 这是一个一级标题`,`## 这是一个二级标题`。 3. **区块引用**:在文本前添加>`引用的文字`,可以创建一个区块引用,多行引用只需在每行开头都添加>即可。 4. **列表**:使用星号(*)、减号(-)或加号(+)创建无序列表,每个项目前加一个符号。如果希望创建有序列表,只需在数字后加一个点(.), 如`1. 第一项`。 5. **代码区块**:将代码包围在三个反引号(```)内,可以创建代码区块。如果指定了编程语言,如````python`,则会高亮相应语言的代码。 6. **分隔线**:在一行中插入三个或更多连续的减号(---)或星号(*),可以创建一条分隔线。 7. **链接**:行内式链接写作`[显示文本](链接地址)`,参考式链接写作`[显示文本][标识符]`,然后在文档任意地方定义`[标识符]: 链接地址`。 8. **强调**:使用星号(*)或下划线(_)包裹文本,可以实现斜体和粗体,如`_强调_`和`**粗体**`。 9. **代码**:使用单个反引号(')包围代码,使其变为行内代码,如`这是一段代码`。 10. **图片**:类似于链接,但使用感叹号(!)开头,如`![](图片地址)`。 11. **反斜杠(\)**:在特殊字符前加反斜杠可以取消其特殊含义,如`\*`不会被解析为强调,而是输出星号本身。 12. **自动链接**:Markdown会自动识别并转换URL为链接,无需额外的语法。 Markdown允许直接嵌入HTML,这对于需要使用特定HTML标签的情况非常有用。然而,为了避免误解析,某些HTML区块元素(如`<div>`, `<table>`, `<pre>`, `<p>`等)需要在前后各有一行空白,且标签不能缩进。例如: ``` 这是一个普通段落。 <table> <tr> <td>Foo</td> </tr> </table> 这是另一个普通段落。 ``` Markdown的设计理念是让书写者专注于内容,而不是过多关注格式,使得文档在保持清晰易读的同时,也能轻松转换成结构化的HTML,便于在网络上传播和发布。通过这种方式,Markdown成为了编写博客、文档、邮件、甚至是书籍的首选工具。