Markdown文档编辑实用语法

一、Markdown 简介

Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。

编写的文档可以导出 HTML 、Word、图像、PDF 等多种格式的文档。

当前许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛、博客上发表消息。

比较代表性的软件支持为 Typora ,软件官网为:https://www.typora.io

编写的文档后缀为 .md

Typora 软件本质是一个具有 Chrome 内核的浏览器,可以使用 shirt + F12 打开开发者工具。

二、Markdown 常用语法

1. 标题语法

使用 # 号可表示 1-6 级标题,一级标题对应一个 # 号,二级标题对应两个 # 号,以此类推。

注意 # 和文字之间需要至少有一个空格。

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

请在 Typora 编写以上内容进行查看效果

2. 文字显示和分割线

两边使用 *** 分别表示斜体和粗体(也可以使用下划线)

两边使用***兼有斜体和粗体效果(也可以使用下划线)

两边使用 ~ 表示删除线

*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
~~BAIDU.COM~~

效果如下:

斜体文本

粗体文本

粗斜体文本

如果想让文字下面有下划线,需要使用HTML标签<u>

<u>带下划线文本</u>

效果如下:

带下划线文本

在一行中,使用三个型号(*)或者三个横杠(-),然后回车,就能够显示出一行分割线

***
---

效果如下:



3. 列表显示

无序列表使用星号()、加号(+)或是减号(-*)作为列表标记,这些标记后面要添加一个空格,然后再填写内容

* 第1项
* 第2项
* 第3项

+ 第1项
+ 第2项
+ 第3项

- 第1项
- 第2项
- 第3项

效果如下:

  • 第1项
  • 第2项
  • 第3项

有序列表使用数字并加上点(.)号来表示

1. 第1项
2. 第2项
3. 第3项

效果如下:

  1. 第1项
  2. 第2项
  3. 第3项

列表还可以进行嵌套使用

1. 第1项:
    - 第1项嵌套的第1个元素
    - 第1项嵌套的第2个元素
2. 第二项:
    - 第2项嵌套的第1个元素
    - 第2项嵌套的第2个元素

效果如下:

  1. 第1项:
    • 第1项嵌套的第1个元素
    • 第1项嵌套的第2个元素
  2. 第二项:
    • 第2项嵌套的第1个元素
    • 第2项嵌套的第2个元素

4. 区块引用

使用大于号(>),后面紧跟一个空格,然后编写文字,就能展示出区块引用样式

> 天道酬勤

效果如下:

天道酬勤


区块是可以嵌套的,只需要使用多个大于号(>)和空格即可,貌似也没有啥太大的用处

> 第1层引用
> > 第2层引用
> > > 第3层引用

效果如下:

第1层引用

第2层引用

第3层引用


区块中可以使用列表:
> 区块中使用列表
> 1. 第一项
> - aaa
> - bbb
> 2. 第二项
> + ccc
> + ddd

效果如下:

区块中使用列表

  1. 第一项
  • aaa
  • bbb
  1. 第二项
  • ccc
  • ddd

列表中也可以使用区块
* 第1项
	> aaaa
	> bbbb
* 第2项
	> cccc
	> dddd

效果如下:

  • 第1项

    aaaa

    bbbb

  • 第2项

    cccc

    dddd


5. 代码块显示

在文字两边使用反引号(`),就可以表示单行代码片段

`我是代码片段`

效果如下:

我是代码片段


使用至少三个反引号(**`**)或者至少三个波浪线(**~**),就能够表示一个代码块,可以指定具体一种语言(可选)
```javascript
$(document).ready(function () {
    alert('Hello World');
});

效果如下:

$(document).ready(function () {
    alert('Hello World');
});

6. 超链接显示

超链接的使用方式如下:

[链接名称](链接地址)
或者
<链接地址>

例如:

我是百度网址的超链接[百度网站](https://www.baidu.com/)
这是一个直接的超链接 <https://fanyi.baidu.com/>

效果如下:

我是百度网址的超链接百度网站
这是一个直接的超链接 https://fanyi.baidu.com


我们可以通过变量来设置一个链接,变量赋值在文档末尾进行:
我是百度网址的超链接[百度网站][mylink]
[mylink]: https://www.baidu.com

效果如下:

我是百度网址的超链接百度网站


7. 图片的显示

图片的使用格式为:

![alt 属性文本](图片地址)
![alt 属性文本](图片地址 "可选标题")

开头一个感叹号 !
接着一个方括号,里面放上图片的替代文字
接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上选择性的title属性的文字

例如:

![百度图片](https://www.jb51.cc/res/2022/10-19/16/6c825ed7ea4cd25657288ab4f7d0227f.png "万能搜索引擎")

效果如下:

百度图片


Markdown 还没有办法指定图片的高度与宽度,如果你需要的话,你可以使用普通的

标签

<img src="https://www.jb51.cc/res/2022/10-19/16/6c825ed7ea4cd25657288ab4f7d0227f.png" width="150">

效果如下:



8. 表格的显示

制作表格使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行

我们可以设置表格的对齐方式:

  • -: 设置内容和标题栏居右对齐。
  • :- 设置内容和标题栏居左对齐。
  • :-: 设置内容和标题栏居中对齐。

例如:

| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

效果如下:

左对齐 右对齐 居中对齐
左对齐单元格 右对齐单元格 居中对齐单元格
左对齐单元格 右对齐单元格 居中对齐单元格

一般情况下,这种使用表格的方式不太实用


三、Markdown 其它

不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。

因为本质上 Markdown 就是 html 语法的另外一种快捷文本编辑方式。

在 Typora 软件中,可以使用快捷键 Ctrl + / 来查看所编辑文档的源码模式。

使用 Shift + F12 可以打开 开发者窗口 ,用于查看所编辑文档的 HTML 源码。


Markdown 使用了很多特殊符号来表示特定的意义,如果需要显示特定的符号则需要使用转义字符。

Markdown 使用反斜杠转义特殊字符,支持以下这些符号前面加上反斜杠来帮助插入普通的符号:

\   反斜线
`   反引号
*   星号
_   下划线
{}  花括号
[]  方括号
()  小括号
#   井字号
+   加号
-   减号
.   英文句点
!   感叹号

当然 Markdown 还支持 流程图时序图甘特图 等文本语法表示,这里就不介绍了。因为语法比较复杂,我个人感觉不太实用,还是实用专门绘图工具绘制完,然后截图放到 Markdown 文档中比较方便。

原文地址:https://www.cnblogs.com/studyjobs/p/15142672.html

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。

相关推荐


文章浏览阅读1.7w次,点赞8次,收藏13次。这里以“TCP协议中的三次握手”来讲一下Markdown编辑器中UML序列图的应用。连接建立的过程: ```sequenceTitle:连接建立的过程客户主机->服务器主机: 连接请求(SYN=1,seq=client_isn) 服务器主机->客户主机: 授予连接(SYN=1,seq=client_isn)n ack=client_isn+1客户主机->服务器主机: 确认(SYN=0,se_markdown 语法sequence
文章浏览阅读1.6w次。写博客经常会用到图片,CSDN-markdown编辑器支持插入在线的网上图片,也可以上传本地电脑上的图片。   通过点击工具栏的图片工具或者按下快捷键“Ctrl+G(MAC系统使用Cmd+G)”打开插入图片对话框: 插入在线图片:  在插入图片对话框的“在线图片”标签模式下,输入或粘贴图片地址,点击确定就可以了;如果要添加图片提示,在图片地址后输入一个空格再输入“图片提示”: Chro_markdown引用在线图片
文章浏览阅读6.5k次,点赞6次,收藏5次。无需上网,离线也能用Markdown写博客  这里就讲一下如何使用一款名为“MarkdownPad”的Markdown编辑器离线写博客。有关下载安装的细节请参考Markdown编辑器“MarkdownPad”下载安装(图)  使用“MarkdownPad”可以通过键盘快捷键和工具栏按钮来使用或者移除 Markdown 格式。MarkdownPad左右栏的分割方式令用户可以实时看到 HTML 格式的_在clion中 离线下载markdown做笔记
文章浏览阅读7.3k次,点赞8次,收藏5次。MarkdownPad是Windows下的一个全功能Markdown编辑器。应该是使用.NET写的,依赖Microsoft .NET 4 Client Profile。下载MarkdownPad下载地址:http://markdownpad.com/ 打开网页后,点击“Download MarkdownPad”按钮开始下载: 如果看到以下页面还是没有开始下载,请点击“restart the_markdown需要下载吗
文章浏览阅读2.9w次,点赞39次,收藏103次。Markdown是一种可以使用普通文本编辑器编写的标记语言,通过类似HTML的标记语法,它可以使普通文本内容具有一定的格式。但是它本身是不支持修改背景色功能的!  从HTML Editor 转到CSDN-markdown编辑器的很多朋友可能有些不适应,明明很简单的背景色功能,这里却找不到了。  CSDN-markdown编辑器是其衍生版本,扩展了Markdown的功能(如表格、脚注、内嵌HTML等等_markdomark中怎么修改代码块底色
文章浏览阅读7.4k次,点赞2次,收藏4次。CSDN-markdown编辑器支持从本机导入Markdown文件的功能,如果你有从其它网站上下载的博客文章或说明文档,或是用软件编写的博客文章或说明文档,想发布到CSDN博客中,就可以使用本功能很方便的完成操作。这里讲一下类似上传文件的实现方式的操作步骤:1、点击工具栏的从本机导入按钮:2、弹出从本机导入对话框:3、点击选择文件,打开文件选择对话框:4、选中需要导入的MD文件,点击打开按钮就导入完_markdown格式的脑图代码怎么导入
文章浏览阅读7.2k次,点赞3次,收藏2次。CSDN-markdown编辑器支持从线上导入Markdown文件的功能,如果你用其它支持Markdown的编辑器在网上写了博客文章或说明档,想发布到CSDN博客中,就可以使用本功能很方便的完成操作。这里以从线上导入GitHub上的一个MD文件为例,说明操作步骤:1、找到GitHub上的一个MD文件:2、点击文件链接进入显示页面:3、点击“Raw”按钮进入MD原始文件页面:4、复制地址栏中的URL地_diagram designer怎么导入markdown
文章浏览阅读1.5w次,点赞5次,收藏8次。CSDN-markdown编辑器锚点链接添加方法 注:经过测试,CSDN-markdown编辑器通过ID属性来支持这一功能!使用Name属性添加锚点是不受支持的,原因是在显示的时候,锚点名称被过虑掉了,如下图: 如果没有过虑的话,使用Name属性这一功能是可以实现的! 而经过博主“eson_15”测试使用ID属性是可行的。在ul标签的li元素上添加锚点链接,li元素上添加锚点链接后在mar
文章浏览阅读3.9k次,点赞7次,收藏7次。Markdown是什么为什么使用MarkdownMarkdown的优点全新的体验如何切换到MarkDown编辑器通过发表文章页面切换到MarkDown编辑器通过博客配置将Markdown设置为默认编辑器初识Markdown编辑器布局总体布局通过博客管理菜单可以切换到HTML编辑器点击工具栏的帮助按钮可以打开帮助面板发表博客设置摘要和标签文章设置发布Markdown是什么?_csdn博客的markdown编辑器
文章浏览阅读3.6k次,点赞2次,收藏2次。CSDN-markdown编辑器支持从本机导入Markdown文件的功能,如果你有从其它网站上下载的博客文章或说明文档,或是用软件编写的博客文章或说明文档,想发布到CSDN博客中,就可以使用本功能很方便的完成操作。这里讲一下拖拽文件到markdown编辑器上的实现方式操作步骤:1、点击工具栏的从本机导入按钮:2、弹出从本机导入对话框:3、打开本地文件夹,将.md文档拖到虚线框里;其实使用Chrome_rmarkdown怎么导入数据框
文章浏览阅读1.4w次,点赞10次,收藏48次。LaTex是什么?LaTeX(LATEX,音译“拉泰赫”)是一种基于ΤΕΧ的排版系统,由美国计算机学家莱斯利·兰伯特(Leslie Lamport)在20世纪80年代初期开发,利用这种格式,即使使用者没有排版和程序设计的知识也可以充分发挥由TeX所提供的强大功能,能在几天,甚至几小时内生成很多具有书籍质量的印刷品。对于生成复杂表格和数学公式,这一点表现得尤为突出。因此它非常适用于生成高印刷质量的科技_markdown and latex: 伪2
文章浏览阅读1.1w次,点赞6次,收藏13次。E文好的同学请查看英文原文: Markdown syntax guide标题# 这是一级标题,相当于HTML中的H1标签## This is an H2###### This is an H6呈现效果:这是一级标题,相当于HTML中的H1标签This is an H2This is an H6段落每个段落从一个新行开始,段落前最好有一个空行。只需按下回车键开始一个新行。例如,像下_markdown 代码块 自动换行
文章浏览阅读3.4k次,点赞2次,收藏3次。代码块用TAB键起始的段落,会被认为是代码块,如下: echo “hello world"; 呈现效果: echo “hello world";如果在一个行内需要引用代码,只要用反引号`引起来就好,如下:Use the `printf()` function.呈现效果: Use the printf() fun_markdown编辑器 左右对照
文章浏览阅读2.1w次,点赞2次,收藏6次。我在云栖社区的聚能聊中发布了一个话题:“”。其中有回复提到:markdown轻巧归轻巧,但也有硬伤,比如插入的图片如何保存的问题。几乎所有的markdown工具都会把图片单独保存在一个地方,这就是说你把自己的.md文件拷贝给别人的时候,还得把图片一并拷给他,而且路径要一模一样!这是妈蛋工具最大的吐槽点,图片就是处理的不好,就是这一点比不上office。其实 markdown 是可以使用 Data_图片摆在markdown里不失真可移动
文章浏览阅读4k次,点赞2次,收藏4次。标题在文字写书写不同数量的#可以完成不同的标题,如下:# 一级标题## 二级标题### 三级标题#### 四级标题##### 五级标题###### 六级标题呈现效果:一级标题二级标题三级标题四级标题五级标题六级标题等号及减号也可以进行标题的书写,不过只能书写二级标题,并且需要写在文字的下面,减号及等号的数量不会影响标题的基数,如下:二级标题=========二级标题---------呈_csdn--md语法 - csdn博客
文章浏览阅读2.5w次,点赞18次,收藏62次。欢迎使用Markdown编辑器写博客本Markdown编辑器使用StackEdit修改而来,用它写博客,将会带来全新的体验哦:Markdown和扩展Markdown简洁的语法代码块高亮图片链接和图片上传LaTex数学公式UML序列图和流程图离线写博客导入导出Markdown文件丰富的快捷键快捷键加粗 Ctrl B 斜体 Ctrl I 引用 Ctrl_csdn的 markdown编辑器
文章浏览阅读2w次,点赞16次,收藏23次。HTML提供了5种空格实体(space entity),它们拥有不同的宽度,非断行空格( )是常规空格的宽度,可运行于所有主流浏览器。其他几种空格(      ‌‍)在不同浏览器中宽度各异。 它叫不换行空格,全称No-Break Space,它是最常见和我们使用最多的空格,大多数的人可能只接触了 ,它是按下sp_markdown空格符
markdown语法1、vscode预览md文件打开侧边预览按完Control+K,再按V,要在英文状态下输入打开预览Control+Shift+V2、代码块使用三个反引号"`"esc键下面的符号框起来,还得在加上编程语言,不加的话就没有高亮显示具体效果如下:intmain(){return0;}3、标题#后面加
这里写自定义目录标题欢迎使用Markdown编辑器新的改变功能快捷键合理的创建标题,有助于目录的生成如何改变文本的样式插入链接与图片如何插入一段漂亮的代码片生成一个适合你的列表创建一个表格设定内容居中、居左、居右SmartyPants创建一个自定义列表如何创建一个注脚注
这加粗样式里写自定义目录标题使用Markdown编辑器新的改变功能快捷键合理的创建标题,有助于目录的生成如何改变文本的样式插入链接与图片如何插入一段漂亮的代码片生成一个适合你的列表创建一个表格设定内容居中、居左、居右SmartyPants创建一个自定义列表如何创建一个注