如何添加目录(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

Logo

魔乐社区(Modelers.cn) 是一个中立、公益的人工智能社区,提供人工智能工具、模型、数据的托管、展示与应用协同服务,为人工智能开发及爱好者搭建开放的学习交流平台。社区通过理事会方式运作,由全产业链共同建设、共同运营、共同享有,推动国产AI生态繁荣发展。

更多推荐