手把手教你Markdown语法
1、Markdown 标题
Markdown里有六种标题,均为若干个
#
加空格组成。
Markdown的“标记符”多由“标点符号+空格”组成。该写空格就写,别忘了。
一级标题(最大字号)对应一个 #
号,二级标题对应两个 #
号,以此类推,可实现1-6个级别的标题。
#
后边需要追加一个空格,空格后边即为标题内容。
注:标题应为独立的一行,并且其上、下应各为一个空白行。
语法示例:
# 一级标题## 二级标题### 三级标题#### 四级标题##### 五级标题###### 六级标题
Tips:日常使用 3 - 5 号标题即可。
渲染效果:
你好
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
2、Markdown 段落
Markdown不同于常规的Word文档,空白行是“切换段落”(分段)用的,并不会渲染成“空行”。因此,在段落后面使用一个空行,以表示重新开始一个段落(推荐)。
也可以在段尾使用“两个以上空格加回车”来实现切换段落(不推荐)。
语法示例1(不分段,仅换行):
我希望有个如你一般的人,如山间清爽的风,如古城温暖的光。
从清晨到夜晚,由山野到书房。只要最后是你,就好。
渲染效果1:
我希望有个如你一般的人,如山间清爽的风,如古城温暖的光。
从清晨到夜晚,由山野到书房。只要最后是你,就好。
语法示例2(进行分段):
我希望有个如你一般的人,如山间清爽的风,如古城温暖的光。从清晨到夜晚,由山野到书房。只要最后是你,就好。
渲染效果2:
我希望有个如你一般的人,如山间清爽的风,如古城温暖的光。
从清晨到夜晚,由山野到书房。只要最后是你,就好。
3、Markdown 斜/粗 体
文字倾斜:
方法1:用 *
(或 _
)左右包起来即可(推荐)。
方法2:用HTML标签 <i> </i>
来实现(不推荐)。
文字加粗:
方法1:用俩 *
(或 _
)左右包起来即可(推荐)。
方法2:也可以用HTML标签 <b> </b>
或 <strong> </strong>
来实现(不推荐)。
斜粗体文字:
用仨 *
(或 _
)左右包起来即可。
示例文本:
*斜体文本*_斜体文本_<i>HTML斜体文本</i>**粗体文本**__粗体文本__<b>HTML加粗内容示例</b><strong>HTML加粗文字</strong>***粗斜体文本***___粗斜体文本___
渲染效果:
斜体文本
斜体文本
斜体文本
粗体文本
粗体文本
加粗内容示例
加粗文字
粗斜体文本
粗斜体文本
4、Markdown 字号/颜色
如果你想指定字号/颜色,可以尝试用html里的 <font> </font>
标签来实现。
正常情况下,字号3应最接近默认大小,颜色采用6位16进制数,由前至后分别代表红绿蓝,每种颜色用2位16进制数表示,最终字体颜色效果为RGB的混合色。
示例文本:
<font size="3">三号文字</font><font size="4">四号文字</font><font size="5" color="#FF0000">五号红字</font><font color="#FF0000">红色文字</font><font color="#FFA500">橙色文字</font><font color="#FFFF00">黄色文字</font><font color="#00FF00">绿色文字</font><font color="#00FFFF">青色文字</font><font color="#0000FF">蓝色文字</font><font color="#A020F0">紫色文字</font><font color="#FFC0CB">粉色文字</font><font color="#A52A2A">棕色文字</font>
渲染效果:
三号文字
四号文字
五号红字
红色文字
橙色文字
黄色文字
绿色文字
青色文字
蓝色文字
紫色文字
粉色文字
棕色文字
对于解析 font
标签中 size
的值,Typora只取出了整数部分。
简记工具提供了快捷键“彩色文字标签”,但这并非最佳方案。下边贴几个常用的标签吧。
- 橙色文字:
<font color="#FF7F00"></font>
渲染示例:橙色文字
- 蓝色文字:
<font color="#0000ff"></font>
渲染示例:蓝色文字
- 四号字:
<font size="4"></font>
渲染效果:
四号字
5、Markdown 微调字号
这个很少有人在Markdown教程里讲到,需要的时候用一下也不错。
借助HTML标签big/small
,即可微调文字大小。
语法示例:
<big>大号文字</big><small>小号文字</small>
渲染效果:
大号文字
小号文字
ChaTi额外扩充了large
标签,以方便微调更大字号,语法示例:
<large>字号增大</large>
注: large
标签仅在ChaTi/轻记内生效,其他任何编辑器都不支持该标签,请谨慎使用。
6、Markdown 删除线
用俩 ~
左右包起来即可,也可以用HTML的 <s> </s>
标签来实现(不推荐)。
语法示例:
~~Markdown 删除线内容~~<s>删除线内容</s>
渲染效果:
Markdown 删除线内容
删除线内容
7、Markdown 下划线
Markdown本身并不提供下划线标签,需要借助HTML的 <u> </u>
标签。
语法示例:
<u>下划线文字</u>
渲染效果:
下划线文字
8、Markdown 无序列表
无序列表是一个项目的列表,此列项目使用粗体圆点进行标记。
Markdown无序列表写法非常简单,减号(或加号、星号)加一个空格即可。
注:推荐使用减号,因为星号常用于斜粗体。
语法示例:
- Markdown无序列表+ Markdown无序列表* Markdown无序列表
渲染效果:
- Markdown无序列表
- Markdown无序列表
- Markdown无序列表
当然啦,还可以用html的 <ul> </ul>
和 <li> </li>
标签来实现(极其复杂,不推荐)。
HTML语法示例:
<ul><li>Coffee</li><li>Milk</li>
</ul>
渲染效果:
- Coffee
- Milk
9、Markdown 有序列表
和无序列表类似,有序列表也是一列项目,列表项目使用数字进行标记。
注:相较于其他文字,列表部分会轻微向右偏移。
Markdown有序列表写法非常简单,数字加小数点,然后加一个空格即可。
语法示例:
1. Markdown有序列表
2. Markdown有序列表
渲染效果:
Markdown有序列表
Markdown有序列表
当然啦,还可以用html的
<ol> </ol>
和<li> </li>
标签来实现(极其复杂,不推荐)。
HTML语法示例:
<ol><li>Coffee</li><li>Milk</li>
</ol>
渲染效果:
- Coffee
- Milk
10、Markdown 嵌套无序列表
无序列表是可以多层嵌套的,在子层列表的行首放两个或更多个空格即可。
语法示例:
- 嵌套列表- 二级列表- 三级列表
渲染效果:
- 嵌套列表
- 二级列表
- 三级列表
- 二级列表
来个复杂点的?
语法示例:
- 儒
- 释
- 道- 书籍- 道德经- 著名人物- 张道陵- 葛玄- 萨守坚- 许旌阳
渲染效果:
- 儒
- 释
- 道
- 书籍
- 道德经
- 著名人物
- 张道陵
- 葛玄
- 萨守坚
- 许旌阳
- 书籍
当然啦,HTML的也是可以写出来的(太复杂,不推荐)。
HTML语法示例:
<ul><li>儒</li><li>释</li><li>道<ul><li>书籍<ul><li>道德经</li></ul></li><li>著名人物<ul><li>张道陵</li><li>葛玄</li><li>萨守坚</li><li>许旌阳</li></ul></li></ul></li>
</ul>
渲染效果:
- 儒
- 释
- 道
- 书籍
- 道德经
- 著名人物
- 张道陵
- 葛玄
- 萨守坚
- 许旌阳
- 书籍
11、Markdown 引用
Markdown中通过 >
(大于号)加一个空格实现 引用
。
语法示例:
> 从你的全世界路过
渲染效果:
从你的全世界路过
进阶玩法:
引用
也可以多级嵌套(连续使用多个 >
,加一个空格),而且支持和其它Markdown标签搭配使用,比如无序列表。
语法示例:
> 一级引用文本
>> 二级引用文本
>> - 二级引用,无序列表
>>> 三级引用文本
>>> * 三级引用,无序列表
渲染效果:
一级引用文本
二级引用文本
- 二级引用,无序列表
三级引用文本
- 三级引用,无序列表
12、Markdown 代码
并不一定真要放代码时才能用这个标签,这里举两个例子:
1.如果要重点突出某个字,可以用行内代码标签
2.如果不想让Markdown渲染某段文字,可以用代码块标签进行包裹
Markdown中代码格式化可以通过三种方式:
行内式:通过一对 ` 包裹单行代码/文字实现;
代码块:通过一对 ```包裹实现,可以指定代码的编程语言,如Python、JavaScript、Rust等,如果渲染器支持,将实现语法高亮;
缩进式:通过缩进至少四个空格实现,部分支持语法高亮。
前两个很常用,缩进式写起来很恶心,不推荐。
ChaTi/轻记APP,代码块支持高亮显示,支持标注以下语言:
brainf*ck , c , clike , clojure , cpp , csharp , css , dart , git , go , groovy , java , javascript , json , kotlin , latex , makefile , markdown , markup , python , scala , sql , swift , yaml
注:请使用真实的语言名称(不是别名)。所以,应用 javascript 而不是 js ,应用 markup 而不是 xml 。另外,所有语言名称一律为小写字母。
语法示例:
1.行内式代码: `import os, sys`2.代码块(无需缩进):\```python
import os, syssys.pathprint(os)
\```3.缩进式:if (isAwesome){return true}
注:为避免标签渲染冲突,代码块标签前面我加了个反斜杠。
渲染效果:
1.行内式代码: import os, sys
2.代码块(无需缩进):
import os, syssys.pathprint(os)
3.缩进式:
if (isAwesome){return true
}
13、Markdown 注释
被注释的文字不会显示出来。
正是基于这个特点,衍生出了ChaTi/轻记的“一键复制”功能(后边会重点讲解)。
推荐写法:
[](注释内容,渲染时不会显示)
Markdown中注释可以通过三种方式实现:
1.HTML注释:
用 <!--...-->
标签来实现注释;
2.HTML标签:
用HTML标签显示属性 style='display: none'
标签来实现注释;
注:要看编辑器有没有解析div标签。
3.HACK方法:
用Markdown解析原理来实现注释。
注:HACK方法基于Markdown解析原理,相较于HTML注释和HTML标签显示属性要稳定得多,但语义化差(不易阅读)。
Tips:HACK方法注释写法很灵活,基于Markdown解析原理即可。以下实例代码仅试举几例,可自由组合。
语法示例:
HTML注释 <!--...--><!-- 我是单行注释,渲染时不会显示。--><!--
我是多行,
段落注释,
渲染时不会显示。
-->HACK方法注释(此处仅是举例,可以利用Markdown解析原理自由组合语法)。[](我是注释,渲染时不会显示。)[注释关键字]:(注释描述。)[#]:<> "我是注释,渲染时不会显示。"
[#]:# "我是注释,渲染时不会显示。"
[注释]:<> "我是注释,渲染时不会显示。"
[注释]:# "我是注释,渲染时不会显示。"
[注释]:// "我是注释,渲染时不会显示。"
[//]:<> "我是注释,渲染时不会显示。"
[//]:# "我是注释,渲染时不会显示。"
渲染效果:
HTML注释
HACK方法注释(此处仅是举例,可以利用Markdown解析原理自由组合语法)。
14、Markdown 任务清单
固定写法,没必要去记,底部给了快捷复制。
语法示例:
- [ ] 未完成- [x] 已完成
渲染效果:
未完成
已完成
15、Markdown 变量
Markdown 中支持变量定义和变量引用,且支持中文。
一处定义,处处使用,而且方便统一修改。
语法示例:
步骤1.定义链接
[百度]:https://www.baidu.com步骤2.引用链接:
引用方式:[网站链接][百度]
渲染效果:
步骤1.定义链接[百度]:https://www.baidu.com
步骤2.引用链接:
引用方式:[自定义文本][百度]
16、Markdown 图片
格式:![Alt Text](img url)
这个不需要手写标签,可通过图床工具。
通过简记调用“插图”,即可自动复制Markdown格式的图片标签。
语法示例:
![图片文字描述](http://p.ananas.chaoxing.com/star3/origin/cdb3acda0bd169904d7aa2bb6557383f.jpg?rw=1080&rh=2160&_fileSize=333667&_orientation=0)
渲染效果:
也支持HTML图片标签,顺便贴一下吧。
HTML语法示例:
<img src = 'http://p.ananas.chaoxing.com/star3/origin/48c864c70e0d42e9ad5318b93a9857a1.jpg?rw=1080&rh=2160&_fileSize=184105&_orientation=0' />
渲染效果:
17、Markdown 链接
有些Markdown工具不支持自动识别http开头的url链接,用<>
包裹链接即可,如:
<https://xiaobeiit.cn>
渲染效果:
https://xiaobeiit.cn
若需指定url链接文本,格式:[文本](url)
语法示例:
[xiaobeiit](https://xiaobeiit.cn)
渲染效果:
xiaobeiit
18、Markdown 锚点
在纯Markdown环境下一般(自信点,去掉这俩字)是无法生效的,需要在网页内展示。如使用Typora导出为.html文件,或使用CSDN等博客平台。
语法示例:
<a href="#标记">锚点标题</a><a id="标记">跳转到此处</a>
渲染效果:
锚点标题
跳转到此处
19、Markdown 表格
语法示例:
| 左对齐 | 居中对齐 | 右对齐 |
| :--| :--: | --: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
渲染效果:
左对齐 | 居中对齐 | 右对齐 |
---|---|---|
单元格 | 单元格 | 单元格 |
单元格 | 单元格 | 单元格 |
单元格 | 单元格 | 单元格 |
单元格 | 单元格 | 单元格 |
20、Markdown 特殊字符
语法示例:
空格符:
小于号:<
大于号:>
和号:&
人民币:¥
版权:©
注册商标:®
摄氏度:°
正负号:±
乘号:×
除号:÷
平方(上标²):²
立方(上标³):³
渲染效果:
空格符:
小于号:<
大于号:>
和号:&
人民币:¥
版权:©
注册商标:®
摄氏度:°
正负号:±
乘号:×
除号:÷
平方(上标²):²
立方(上标³):³
注:在空格符的上下方各插入一个空行,即可在渲染时显示空白行。
21、Markdown 对齐文字
Markdown并不提供“居中”等语法标记,需要借助HTML标签来实现。
语法示例:
center标签:<center>居中文字</center>align标签:<p align=center>居中文字</p>align标签:<p align=right>右对齐文字</p>
渲染效果:
居中文字
居中文字
右对齐文字
左对齐
22、Markdown 媒体文件
播放视频代码:
<video id="video" controls="" preload="none" poster="封面图链接"><source id="mp4" src="视频地址" type="video/mp4"></video>
播放音频代码:
<audio id="audio" controls="" preload="none"><source id="mp3" src="音频地址"></audio>
示例:
23、Markdown 联系方式
QQ聊天
Markdown和HTML的链接标签均可,uin即为QQ号。
[QQ联系](http://wpa.qq.com/msgrd?v=3&uin=1653131174&site=qq&menu=yes)<a target="_blank" href="http://wpa.qq.com/msgrd?v=3&uin=1653131174&site=qq&menu=yes">QQ联系</a>
渲染效果:
QQ联系
QQ联系
yun://art.copy/?t=)
邮件反馈
<a target="_blank" href="mailto:1653131174@qq.com?subject=小北IT用户反馈">发送邮件</a>
mailto参数为收件邮箱,subject参数为邮件主题,a标签参数即为要显示的文本。
渲染效果:
发送邮件
手把手教你Markdown语法相关推荐
- 菜鸟教程 MarkDown语法
菜鸟教程之MarkDown语法 MarkDown标题 MarkDown段落 MarkDown字体 MarkDown分隔线 MarkDown删除线 MarkDown脚注 MarkDown列表 MarkD ...
- 手把手教你建github技术博客
适合人群 喜欢写Blog的人 有一定的编程基础 爱折腾的人 熟练使用版本控制Git 了解使用Github 熟悉基本的MarkDown语法 环境准备 安装Git 下载 msysgit 并执行即可完成安装 ...
- 手把手教你使用 VuePress 搭建个人博客
手把手教你使用 VuePress 搭建个人博客 有阅读障碍的同学,可以跳过第一至四节,下载我写好的工具包: git clone https://github.com/zhangyunchencc/vu ...
- 保姆级教程:手把手教你搭建个人网站
保姆级教程:手把手教你搭建个人网站 前言 准备与搭建 1.Git管理工具的下载与安装 2.nodejs环境安装 3.hexo博客框架下载 npm换国内源 使用npm下载hexo博客框架 初始化mybl ...
- 小白都能看懂的实战教程 手把手教你Python Web全栈开发(DAY 3)
小白都能看懂的实战教程 手把手教你Python Web全栈开发 Flask(Python Web)实战系列之在线论坛系统 第三讲 这是小白都能看懂的实战教程 手把手教你Python Web全栈开发 的 ...
- 手把手教你用vuepress搭建自己的网站(2)
虽互不曾谋面,但希望能和您成为笔尖下的朋友 以读书,技术,生活为主,偶尔撒点鸡汤 不作,不敷衍,意在真诚吐露,用心分享 点击左上方,可关注本刊 标星公众号(ID:itclanCoder) 如果不知道如 ...
- 手把手教你从0开始搭建个人博客,东半球最详细的保姆级博客搭建部署教程 | 程序员人手必备个人博客网站
Hello 小伙伴们大家好,我是雷小帅! 想象一下你有一个技术博客,然后把网址写在了简历上,面试官点击鼠标打开了这个网站,然后被惊艳了,最后面试的结果你懂得-- 好了,今天的主题就是手把手教大家从零开 ...
- 小白都能看懂的实战教程 手把手教你Python Web全栈开发(DAY 1)
小白都能看懂的实战教程 手把手教你Python Web全栈开发 Flask(Python Web)实战系列之在线论坛系统 第一讲 博主博客文章内容导航(实时更新) 更多优质文章推荐: 收藏!最详细的P ...
- 手把手教你使用hexo搭建属于你的个人博客
前言 每当看到别人精美的个人博客时,不知你是否有一点点的羡慕.别急,现在我就来手把手教你搭建自己的个人博客. 在技术日趋成熟的今天,有着很多种快速生成博客的框架:Hexo,Jekyll,Wordpre ...
- 【保姆级教程】手把手教你用github制作学术个人主页(学者必备)
很多朋友到了本科生或者研究生或者博士生的高年级,有了制作个人主页的需求,今天这一期博客将以academicpages模板为例,手把手教你快速制作一个简洁能用的个人主页. 1.首先你需要拥有一个gith ...
最新文章
- eclipse 切换svn账号
- IM云将给在线教育带来哪些变革?
- linux 基于qt assistant制作软件帮助文档,基于Qt Assistant的软件帮助系统
- 二进制数据结构:JavaScript中的树和堆简介
- lambdapython语法_Python中lambda表达式的语法与应用
- 如何在Delphi 中调用C#生成的DLL类库
- Metamaterials perform image compression before light reaches the sensor(微波成像,拍摄与压缩同步进行)
- Flink CDC 系列 - Flink MongoDB CDC 在 XTransfer 的生产实践
- Windows下phpstudy nginx.conf 配置PHP项目
- 凤凰os linux双系统,逍遥安卓模拟器双系统无缝连接完胜Remix、凤凰OS
- JSP内置对象及其常用方法
- 什么是脏数据,缓存中是否可能产生脏数据,如果出现脏数据该怎么处理?
- 【BZOJ4011】【HNOI2015】落忆枫音 题解
- 声散射 matlab,一种基于声波散射的高强度聚焦超声声场测量方法与流程
- 蓝牙杂散超标_蓝牙杂散问题
- 用友NC系统考勤机自动同步方案(适合大型商超)
- 常见网络故障排查方法
- QQ空间十亿级视频播放技术优化揭密
- python小黄鸡nlp聊天机器人
- 法兰克机器人循环编程_【发那科】FANUC机器人循环指令介绍
热门文章
- 人事面试java需要注意点_程序员hr面试注意事项
- mysql数据库 with as用法
- 计算机课玩游戏检讨书,上微机课玩游戏检讨书.doc
- asp.net配置文件connectionStrings加密和解密
- 08年计算机组成原理自考试卷,2008年04月自学考试02318《计算机组成原理》试题...
- 从敏思博客的倒闭事件看历史重现...
- 2022《福布斯》富豪榜发布,FTX联合创始人Gary Wang上榜
- 一些时间日期函数,转自华软
- Chrome 批量删除指定站点历史记录
- php包含那点事情[WOOYUN]