Markdown语法教程
Markdown 是一种轻量级标记语言,创始人为 John Gruber。它允许人「使用易读易写的纯文本格式编写文档,然后转换成有效的 XHTML(或者 HTML)文档」。——维基百科
背景
优点
- 专注于文字内容;
- 纯文本,易读易写,可以方便地纳入版本控制;
- 语法简单,没有什么学习成本,能轻松在码字的同时做出美观大方的排版。
使用场景
- 各类代码托管平台
主流的代码托管平台,如 GitHub、GitLab、BitBucket、Coding、Gitee 等等,都支持 Markdown 语法,很多开源项目的 README、开发文档、帮助文档、Wiki 等都用 Markdown 写作。 - 技术社区和写作平台
StackOverflow、CSDN、掘金、简书、GitBook、有道云笔记 - 论坛
V2EX、光谷社区
各平台可能采用不同语言实现的 Markdown 解析引擎,或采用同一解析引擎的不同版本,而且可能有不同程度的定制与扩展,这导致在不同平台上使用 Markdown 写作时体验并不完全一致。不过幸好对于大家公认的一些标准语法,各家都是支持的。
编辑工具
理论上任何一款文本编辑器都能用于编辑 Markdown 文档,它们分别提供了不同程度的语法高亮、预览等功能,以下只是列举其中一部分,选择自己称手的即可。
- 推荐编辑器
Typora / VS Code - 传统编辑器
Vim / Emacs / Sublime Text / Notepad++ - IDE 自带编辑器
IntelliJ IDEA / Android Studio / WebStorm - 专用编辑器
Ulysses / Mou / Markpad - 在线编辑器
CSDN / 简书
语法
标题
Markdown:
# atx-style 一级标题## 二级标题###### 六级标题Setext-style 一级标题
===二级标题
---
预览效果:
atx-style 一级标题
二级标题
六级标题
Setext-style 一级标题
二级标题
对应 HTML:
<h1>atx-style 一级标题</h1><h2>二级标题</h2><h6>六级标题</h6><h1>Setext-style 一级标题</h1><h2>二级标题</h2>
段落
中间没有空行的连续不断的几行文字被视为一个段落。
Markdown:
白日依山尽,黄河入海流。
(句号后面没空格)欲穷千里目,更上一层楼。
(句号后面有俩空格)
预览效果:
白日依山尽,
黄河入海流。
(句号后面没空格)
欲穷千里目,
更上一层楼。
(句号后面有俩空格)
对应 HTML:
<p>白日依山尽,</p><p>黄河入海流。
(句号后面没有空格)</p><p>欲穷千里目,</p><p>更上一层楼。<br>(句号后面有俩空格)
</p>
行内格式
对段落或者部分文本的强调效果。
Markdown:
后面俩字**加黑**后面俩字*斜体*
预览效果:
后面俩字加黑
后面俩字斜体
对应 HTML:
<p>后面俩字<strong>加黑</strong>
</p>
<p>后面俩字<em>斜体</em>
</p>
引用块
Markdown:
> 引用块段落一。
>
> 引用块段落二。
>> 内嵌引用块段落一。
>
> ### 引用块内的标题
预览效果:
引用块段落一。
引用块段落二。
内嵌引用块段落一。
引用块内的标题
对应 HTML:
<blockquote><p>引用块段落一。</p><p>引用块段落二。</p><blockquote><p>内嵌引用块段落一。</p></blockquote><h3 id="引用块内的标题">引用块内的标题</h3>
</blockquote>
超链接
Markdown 支持行内式链接和引用式链接。
Markdown:
行内式 [博学de叫兽](http://zhangchong.xin/ "博学de叫兽") 链接,带 title。行内式 [博学de叫兽](http://zhangchong.xin/) 链接。引用式 [博学de叫兽][1] 链接。引用式 [博学de叫兽][2] 链接,带 title。[1]: http://zhangchong.xin/
[2]: http://zhangchong.xin/ "博学de叫兽"
预览效果:
行内式 博学de叫兽 链接,带 title。
行内式 博学de叫兽 链接。
引用式 博学de叫兽 链接。
引用式 博学de叫兽 链接,带 title。
对应 HTML:
<p>行内式 <a href="http://zhangchong.xin/" title="博学de叫兽">博客</a> 链接,带 title。</p><p>行内式 <a href="http://zhangchong.xin/">博学de叫兽</a> 链接。</p><p>引用式 <a href="http://zhangchong.xin/">博学de叫兽</a> 链接。</p><p>引用式 <a href="http://zhangchong.xin/" title="博学de叫兽">博学de叫兽</a> 链接,带 title。</p>
图片
在超链接的写法前加一个 !
,就是引用图片的方法。
Markdown:
![avatar](https://avatar.csdn.net/8/C/2/3_u012102104.jpg)
预览效果:
对应 HTML:
<img src="https://avatar.csdn.net/8/C/2/3_u012102104.jpg" alt="avatar">
列表
包括有序列表和无序列表。
Markdown:
- 苹果
- 葡萄
- 榴莲1. 苹果
2. 葡萄
3. 榴莲
预览效果:
- 苹果
- 葡萄
- 榴莲
- 苹果
- 葡萄
- 榴莲
对应 HTML:
<ul><li>苹果</li><li>葡萄</li><li>榴莲</li>
</ul>
<ol><li>苹果</li><li>葡萄</li><li>榴莲</li>
</ol>
其中无序列表的标记可以使用 +
、-
或 *
,有序列表前的数字可以是乱序的。
代码块
支持行内代码和代码块。
Markdown:
Android 里使用 TextUtils
类的 isEmpty
方法来判断字符串是否为空。
```java
if (TextUtils.isEmpty(text)) {return null;
}
```
预览效果:
Android 里使用 TextUtils
类的 isEmpty
方法来判断字符串是否为空。
if (TextUtils.isEmpty(text)) {return null;
}
对应 HTML:
<p>Android 里使用 <code>TextUtils</code> 类的 <code>isEmpty</code> 方法来判断字符串是否为空。</p><div class="highlight highlight-source-java"><pre><span class="pl-k">if</span> (<span class="pl-smi">TextUtils</span><span class="pl-k">.</span>isEmpty(text)) {<span class="pl-k">return</span> <span class="pl-c1">null</span>;
}</pre></div>
上例中的语言标记 java
可选填,可用于在编辑器和渲染后的效果里添加语法高亮。块式代码也可以对整个代码段缩进四个空格,或一个 Tab 来实现。
水平分割线
使用一个单独行里的三个或以上 *
、-
来生产一条水平分割线,它们之间可以有空格。
Markdown:
***------ - -
预览效果:
对应 HTML:
<hr /><hr /><hr />
嵌入 HTML
Markdown 标记语言的目的不是替代 HTML,也不是发明一种更便捷的插入 HTML 标签的方式。它对应的只是 HTML 标签的一个很小的子集。
对于那些没有办法用 Markdown 语法来对应的 HTML 标签,直接使用 HTML 来写就好了。
扩展语法
本节的内容是介绍一些受到广泛支持的 Markdown 扩展语法。
表格
Markdown:
| 编号 | 姓名(左) | 年龄(右) | 性别(中) |
| ----- | :-------- | ---------: | :------: |
| 0 | 张三 | 28 | 男 |
| 1 | 李四 | 29 | 男 |
预览效果:
编号 | 姓名(左) | 年龄(右) | 性别(中) |
---|---|---|---|
0 | 张三 | 28 | 男 |
1 | 李四 | 29 | 男 |
对应 HTML:
<table><thead><tr><th>编号</th><th align="left">姓名(左)</th><th align="right">年龄(右)</th><th align="center">性别(中)</th></tr></thead><tbody><tr><td>0</td><td align="left">张三</td><td align="right">28</td><td align="center">男</td></tr><tr><td>1</td><td align="left">李四</td><td align="right">29</td><td align="center">男</td></tr></tbody>
</table>
任务列表
在 GitHub / GitLab 里有较好的支持。
Markdown:
- [x] 洗碗
- [ ] 清洗油烟机
- [ ] 拖地
预览效果:
- 洗碗
- 清洗油烟机
- 拖地
对应 HTML:
<ul class="contains-task-list"><li class="task-list-item"><input type="checkbox" id="" disabled="" class="task-list-item-checkbox" checked=""> 洗碗</li><li class="task-list-item"><input type="checkbox" id="" disabled="" class="task-list-item-checkbox"> 清洗油烟机</li><li class="task-list-item"><input type="checkbox" id="" disabled="" class="task-list-item-checkbox"> 拖地</li>
</ul>
删除线
Markdown:
后面三个字打上~~删除线~~。
预览效果:
后面三个字打上删除线。
对应 HTML:
<p>后面三个字打上<del>删除线</del>。</p>
自动链接
自动链接扩展,即:当识别到 URL,或用 <
、>
包括的 URL 时,会自动为其生成 a
标签。
Markdown:
http://zhangchong.xin/<admin@zhangchong.xin>
预览效果:
http://zhangchong.xin/
admin@zhangchong.xin
对应 HTML:
<p><a href="http://zhangchong.xin/">http://zhangchong.xin/</a></p><p><a href="mailto:<admin@zhangchong.xin>"><admin@zhangchong.xin></a></p>
emoji
以 GitHub Pages 为例。
Markdown:
:camel: :blush: :smile:
预览效果:
? ? ?
对应 HTML:
<p><img class="emoji" title=":camel:" alt=":camel:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/1f42b.png" height="20" width="20"><img class="emoji" title=":blush:" alt=":blush:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/1f60a.png" height="20" width="20"><img class="emoji" title=":smile:" alt=":smile:" src="https://assets-cdn.github.com/images/icons/emoji/unicode/1f604.png" height="20" width="20">
</p>
拓展进阶
想象力丰富的工程师们还扩展了很多基于 Markdown 的玩法,包括但不限于:
- 画流程图和时序图
- 插入数学公式
- 用 Markdown 做 PPT
- 用 Markdown 写微信公众号
Markdown语法教程相关推荐
- Markdown语法教程,使用Typora
Markdown 语法教程 Markdown 简介 Markdown 是一种轻量级标记语言,具有纯文本格式语法. Markdown 标题语法 # 标题名字 (#井号个数代表标题级数,#和标题之间有一个 ...
- Typora教程,Markdown语法教程
前言 一次偶然的机会,让我接触到了 .md 文档,进而开始摸索,并意外结识了 Typora 这个编辑器. 一.MarkDown 1.1 简介 Markdown 是一种轻量级标记语言,创始人为 John ...
- 使用Markdown语法写的笔记.2
使用Markdown语法写的笔记(一级标题) 二级标题 (## (加空格) 1.這篇筆記用於記錄本人目前為止所學到的markdown語法和一些經驗.(三级标题### 加空格)) 一級標題和二級標題都是 ...
- markdown语法简明教程(一)
markdown语法简明教程(一) Markdown 是一种轻量级标记语言,创始人为约翰·格鲁伯(John Gruber). 它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的 XHTML( ...
- 菜鸟教程 MarkDown语法
菜鸟教程之MarkDown语法 MarkDown标题 MarkDown段落 MarkDown字体 MarkDown分隔线 MarkDown删除线 MarkDown脚注 MarkDown列表 MarkD ...
- Markdown编辑器推荐与语法教程--图片版
请参考Markdown编辑器推荐与语法教程--展示版或者Markdown编辑器推荐与语法教程--展示版看具体效果,当然,大家也可以下载Mou亲自体验一把 End
- Typora markdown语法基础教程
提示:文章写完后,目录可以自动生成,如何生成可参考右边的帮助文档 markdown语法大全 文章目录 markdown语法大全 一,markdown标题 二,markdown代码块 三,markdow ...
- wiki php markdown,一款支持Markdown语法的Wiki知识管理系统:Wikitten搭建教程
简介 Wikitten是一款开源Wiki知识管理系统,使用PHP开发,支持Markdown语法,无需数据库,自动生成树形目录,适合用来做个人Wiki知识库. 截图 安装 环境要求:PHP >= ...
- Markdown语法格式--笔记与教程
Markdown介绍 Markdown是一种轻量级的标记语言,使用普通的文本编辑器,通过简单的标记语法,就可以实现漂亮的排版,被越来越多的写作爱好者.程序员所使用.Markdown自成格式,不依赖任何 ...
最新文章
- 万字详解,JDK1.8新特性的Lambda、Stream和日期的使用详解
- 关于AVR单片机熔丝位的设置和拯救方法大全 AVR单片机熔丝位的设置和详细的拯救方法...
- android入门知识,android基础知识学习笔记
- 汉诺塔问题详细解析zufeoj
- ccf_201712-2
- 在linux上处理base64加密和解密
- 解决浏览器兼容性问题面试题_如果不解决技术面试问题,就无法解决技术多样性问题。 这是数据。...
- nginx限流方案的实现(三种方式)
- 编译条件编译——判断当前使用的编译器及操作系统
- BugkuCTF web5
- JSP九大内置对象的作用和用法
- 产品经理入门知识梳理
- (c语言)将一个三位数逆序输出
- HTC G14解锁S-OFF、刷机、获取ROOT权限
- android的混淆器
- 电脑桌面打开计算机窗口,电脑怎么打开运行窗口
- win7声音图标不见,此图标当前处于未活动状态
- 分享个自己Python爬虫时的浏览器标识库
- js控制元素左右缓慢移动和页面上下缓慢移动
- JAVA基础---集合(一)--集合框架概述
热门文章
- 蚂蚁金服阳振坤:用10年时间打造一个“顶天立地”的产品
- 《大学“电路分析基础”课程实验合集.实验五》丨线性有源二端网络等效电路的研究
- WORD设置从开始页数算总页数
- 高德地图轨迹回放功能
- WORD里,如何在同一个文档中为不同页面,设置不同的页眉和页脚
- STM32 FSMC TFT LCD
- SqlServer存储过程中循环的使用
- 《机器学习实战》(八)-- 树回归
- Spring Boot--Druid连接池的配置方法
- 双卡版本不插卡的情况下状态栏中只显示了一个信号图标,而不是两个信号图标,如何修改为2个图标