Markdown语法手册:易读易写的原则与HTML兼容
3星 · 超过75%的资源 需积分: 35 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成为了编写博客、文档、邮件、甚至是书籍的首选工具。
点击了解资源详情
点击了解资源详情
点击了解资源详情
2023-08-21 上传
2016-03-26 上传
2018-07-10 上传
171 浏览量
2022-08-03 上传
普通网友
- 粉丝: 146
- 资源: 6
最新资源
- EnderalVREssentials
- wNjsCppBasic:编写本地NodeJs模块的工具集合
- code
- QuickCategory-for-Outlook
- 4-求职简历-word-文件-简历模版免费分享-应届生-高颜值简历模版-个人简历模版-简约大气-大学生在校生-求职-实习
- WxTools (Weather Data Tools):该软件包收集并显示Oregon Scientific的天气数据。-开源
- qianlizhixing12.github.io
- yzt4ios:易掌通ios版仓库
- MySQL学习基础SQL练习记录.zip
- storage
- Memory-Game:GWG-记忆游戏
- hyve-backend:简单的学习平台(带有REST API的Django后端)
- 贝加莱学习资料,入门和精通
- 捕鱼达人Java课程实践项目.zip
- tvk-poc:TVK POC资产和指南
- evaluating:PHP代码根据表格填写技能评估报告