本文主要介绍了Markdown的基本概念和主要语法,部分扩展语法。
Markdown定义:
是一个文本-HTM转换工具,定义了一种轻量级标记语言,根据其语法,可以将纯文本在html上输出为期望格式的富文本。
Markdown语法在线练习网址:
Markdown在线教程:
https://www.markdownguide.org/
https://www.markdowntutorial.com/lesson/1
Markdown练习工具:
其它相关库、服务、编辑器:
https://github.com/mundimark/awesome-markdown
Markdown的工作原理:
- 使用文本编辑器或者MarkDown Application创建一个带MarkDown语法标记的文本,并存储为.md或者markdown扩展名的文件。
- 然后应用带有MarkDown解析器/处理器的应用程序,如桌面应用程序,或者web浏览器,打开该文件进行解析并展示为HTML格式网页。
- 也可以将显示好的页面转存为PDF等格式。
注意:Markdown application and Markdown processor是两种不同的组件,一般application 里包含processor。
MarkDown优点:
方便记笔记,创建网页格式内容,可印刷文本;
一般用于博客、Github、WordPress、带语法格式笔记本
Markdown基本语法:
所有的Markdown 应用支持John Gruber的原始语法规范,也支持HTML标记,比如图像标签
创建标题Headings:
在单词或者短语前加#,几个#就是几级标题,如###对应HTML的<h3>标签,如下:
交替句法?
分段:
添加一个空行来进行分段,等于对上下两段各自添加<p>标签
分行:
在行尾使用两个或者更多的空格,然后按回车,等于HTML中添加一个<br>标签
强调:
加粗文本:使用成对的两个星号或者下划线围绕文本,等于使用</strong>标签包围文本
意大利体文本:使用成对的一个星号或者下划线包围文本,等于</em>标签包围文本。
加粗并且使用意大利体:成对的三个星号或者下划线包围文本等价于</em></strong>
引用:
在文本段落前添加>符号,引用该段文本
引用多段:
在分段的空行头部添加>符号
嵌套引用:
内嵌的段落使用>>开始符号
其它引用格式,需要测试一下:
如点号,在段落开头使用> - ,注意使用空行分割段落
有序列表,或者无序列表
创建有序列表,使用1. 格式,第一个编号需要填写,其他的可以自动生成
创建无序列表,使用 - 或 * 或+ 来标记
在list中嵌入段落、行,不加项目编号的,添加一各空行,然后在要输入的文本前缩进四个空格或者Tab长度文本,可以继续保留之前的编号。
插入代码块:
一般按照代码格式,缩进四个空格或者TAB即可。
如果是在list中添加代码块,开头添加8个空格或者2个TAB。
插入图片
![替换文字][图片的path或者URL "title "]
将一个单词或者短语作为code,使用单引号包围它
插入引号:使用双引号来插入单引号
插入代码块:使用四个空格,或者tab键
<html>
<head>
</head>
</html>
创建标尺线:
使用三个***或者---
创建超文本连接:
使用中括号[]包围要连接的文本,后面紧跟小括号()包围网页链接
My favorite search engine is [Duck Duck Go](https://duckduckgo.com).
My favorite search engine is Duck Duck Go.
为创建的超文本链接添加鼠标悬浮后显示的标题:
在小括号()的网址后,加个空格以及""包围说明的文字
My favorite search engine is [Duck Duck Go](https://duckduckgo.com "The best search engine for privacy").
My favorite search engine is Duck Duck Go.
直接输入可以点击的URL或者邮箱:
使用尖括号引用URL或者邮箱
<https://www.markdownguide.org>
<fake@example.com>
对超链接格式化,**加粗或者*变为意大利体:
在整体前加两个星号**
I love supporting **[EFF](https://eff.org)**.
This is the *[Markdown Guide](https://www.markdownguide.org)*.
I love supporting the EFF.
This is the Markdown Guide.
论文或者网址引用写法:
https://www.markdownguide.org/basic-syntax#headings
删除线:
使用两个~~包围住待删除文字
~~The world is flat.~~ We now know that the world is round.
The world is flat. We now know that the world is round.
任务列表:
使用横杠和[x][]表示打对号或者空的
- [x] Write the press release
- [ ] Update the website
- [ ] Contact the media
转义字符:
在专用符号前添加\,可以得到原始的符号
\* Without the backslash, this would be a bullet in an unordered list.
* Without the backslash, this would be a bullet in an unordered list.
包括:
Markdown扩展语法:
在基本语法章节介绍了John Gruber的原始语法规范,但是对有的人来说,功能不够用。许多人添加了一些高级语法,包括tables, code blocks, syntax highlighting, URL auto-linking, and footnotes,这些语法可以有基本语法组成或者安装Markdown processor的扩展文件来使用,并且大多数的Markdown processor支持安装扩展文件。
带扩展语法的Markdown applications