markdown的使用、TOC
文章目录
如何添加目录(TOC)
TOC(table of contents)(目录)(内容表)。
TOC代表目录,属于通用叫法。
开头添加[toc]即可,如下代码:
@[toc] # 默认相当于 @[toc](文章目录)
@[toc](自定义目录名) #
实现锚点的功能
设置锚点,给html元素设置个id即可(通过name也能设置锚点,但是需要在a标签中)。
例如这里设置个锚点:
<a id="maodian1">我是锚点1</a>
链接到锚点(以下2种都可以):
方法1: href指向锚点。
<a>是一种特殊的标签,可以是锚点,也可以是链接(如果加id就是锚点,加href就是链接)
<a href="#maodian1">链接到maodian1</a>
方案2:使用markdown的链接锚点语法。
语法:[]中的表示展示名,()中填写 #锚点名 ,例如:#maodian1
[链接到maodian1](#maodian1)
锚点在编辑页面可以跳转,在查看界面无法跳转
笔者出现过的错误例子:
[答案](#答案)
此处间隔n行内容
<a id="答案">答案</a>
结果发现不跳转。
后来发现是中文的问题,换为英文问题解决。 总结如下:
1、必须全小写。
实测大写也可以,中文的话在编辑页面可以跳转,查看界面无法跳转。
2、不要有空格。
这个不说了,基本常识,有空格会识别为2个单词。
3、_、(、)需要去掉。
下划线实测没问题,因为本来就是通用命名的一部分。小括号确实不推荐,因为很多网站中的小括号都有特殊的作用。
列表的通用规则
| 预期 | 动作 |
|---|---|
| 插入一行 | 行尾回车 |
| 插入内容 | 双击回车(相当于先插入列表行,又取消) |
| 连续插入多行 | 回车+空格(或者任意字符,推荐#或tab吧) 因为连续回车,第2次会变变为内容行 |
使用有序列表
用法: 数字+点号+空格(不要忘了空格)
如下例子:
1. 项目1
2. 项目2
3. 项目3
如何分页
三个dash(中划线)即可。
实现多对多立体的功能
例如要做服务器图表。
一个服务器会有多个项目。
一个项目可能会被多个服务器部署。
解决方案:
拿出一个维度当标题。另外一个用锚点。
就可以实现多对多了。
文字包围(键盘文本)
刚见到时蒙了,心想这个效果怎么打出来,我可没见过。
ctrl
这其实不是markdown语法,而是属于html标签。
实现树形结构、折叠代码
markdown直接是不支持的,可以通过和html结合来实现。
代码:
<details>
<summary>点击查看代码</summary>
```python
def say_hello():
print("Hello, World!")
注:如下代码直接在博客打开是没有效果的,需要以html打开,但是又比较习惯markdown格式的博客,还是没有好的办法。
表格
表格是非常常用的一个功能。
代码:
标题行 | 标题行 | 标题行
--- | --- | ---
内容行 | 内容行 | 内容行
内容行 | 内容行 | 内容行
可以在表格中换行。
表格中可以使用反引号(`)、强调符号(==)等。
设置表格的对齐
在表格中,分隔行中的:(英文冒号)可以设置对齐。
:-- 表示左对齐
--: 表示右对齐
:--: 表示居中,默认就是居中
代码如下:
左对齐|居中|右对齐
:----|:--:|----:
程咬金|慕容复|段正淳
秦琼|乔峰|段誉
效果如下:
| 左对齐 | 居中 | 右对齐 |
|---|---|---|
| 程咬金 | 慕容复 | 段正淳 |
| 秦琼 | 乔峰 | 段誉 |
csdn中插入代码块时如何插入指定类型的代码块
例如想插入java,但是默认总插入js。
只需要先手动点下上方的代码块,选java,后续用快捷键插入的时候还会是这个类型。
其他
文档
官网首页:
https://www.markdownguide.org/
简单文档地址:
https://www.markdownguide.org/cheat-sheet/
markdown github地址:
https://github.com/mattcone/markdown-guide
markdown-here
markdown-here是浏览器插件,官网地址:
https://markdown-here.com/
markdown github地址:
https://github.com/adam-p/markdown-here
魔乐社区(Modelers.cn) 是一个中立、公益的人工智能社区,提供人工智能工具、模型、数据的托管、展示与应用协同服务,为人工智能开发及爱好者搭建开放的学习交流平台。社区通过理事会方式运作,由全产业链共同建设、共同运营、共同享有,推动国产AI生态繁荣发展。
更多推荐


所有评论(0)