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

"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成为了编写博客、文档、邮件、甚至是书籍的首选工具。
185 浏览量
206 浏览量
517 浏览量
164 浏览量
651 浏览量

普通网友
- 粉丝: 146
最新资源
- 虚幻引擎4经典FPS游戏开发包解析
- 掌握LaTeX中psfig.sty的使用技巧
- 探索X102 51学习板:深入嵌入式系统开发
- 深入理解STM32外部中断的实现与应用
- 大冶市数字高程模型(DEM)数据详细解读
- 俄罗斯方块游戏制作教程:Protues实现指南
- ASP.NET视频点播系统源代码及论文:多技术项目资源集锦
- Platzi JavaScript课程体系:全面覆盖初、中、高级
- cutespotify:跨平台MeeSpot音乐播放器兼容SailfishOS
- PictureEx类:在VC6下显示jpg与gif动图
- 基于stc89C51的数字时钟Proteus仿真设计
- MATLAB全面基础教程与实践技巧分享
- 实现双行文字向上滚动效果的js插件
- Labview温度报警系统:实时监控与声光警报
- Java官网ehcache-2.7.3实例教程
- A-Frame超级组件集:超帧的创新与应用