MD 自定义语法备忘，查阅自用

便捷跳转

代码块

使用例：

```js:demo-code.js showLineNumbers focusBlur maxH hidecode
var num1, num2, sum;
// hl -11
num1 = prompt("Enter first number");
num2 = prompt("Enter second number");
sum = parseInt(num1) + parseInt(num2); // "+" means "add"
alert("Sum = " + sum); // "+" means combine into a string
```

呈现效果：

demo-code.js

var num1, num2, sum;
num1 = prompt("Enter first number");
num2 = prompt("Enter second number");
sum = parseInt(num1) + parseInt(num2); // "+" means "add"
alert("Sum = " + sum); // "+" means combine into a string

表格 1

语法	效果	其他注意事项
`js:some-title.js`	声明标题
`hl-11`	行间注释，声明下一行为高亮行
`hl-00` & `hl-99`	行间注释，声明指定范围的高亮行	成对出现
`showLineNumbers`	开启行号显示	有高亮行情况下应开启此声明
`focusBlur`	开启模糊聚焦效果	有高亮行情况下才可选择开启此声明
`maxH`	代码块最大高度限制
`hidecode`	默认折叠收起代码块
`diff-js`	支持 Diff 模式
`{1,3-4}`	meta 元数据处声明高亮行	废弃，请使用行间注释风格

插入图片

![alt info@@size=200x200@@link=http://placekitten.com@@caption=cute cat placeholder](http://placekitten.com/200/200)

呈现效果：

cute cat provider

表格 2

简要说明：本站扩充了原始的 ![alt](imageUrl) 语法

语法	效果	其他注意事项
`[altInfo]`	图片 alt 信息	不可缺失
`@@size=[widthxheight]`	声明图片的 renderSize	a. 可缺省，但不推荐; b.不用是图片实际宽高尺寸（next/Image） c.尺寸表示上，允许形如 `300x400`, `300X400`, `300/400`, `300*400` 的表示
`@@link=[URL]`	图片的底部标题支持点击跳转到指定链接	可缺省
`@@caption=[text]`	图片的底部标题文案	可缺省，此时由头部的 alt info 兜底

文本高亮块

:::tip
tick tip.
:::

呈现效果：

:::gpt@hide:"42 具有什么特别含义"
在一些文化和社会背景中，数字42被认为具有特殊的含义。这源自道格拉斯·亚当斯（Douglas Adams）的科幻系列小说《银河系漫游指南》（The Hitchhiker's Guide to the Galaxy）。在该系列中，超级智能电脑Deep Thought被询问生命、宇宙以及一切的终极问题时，结果是42。
<br/>这个故事引发了人们对42的讨论和解读，形成了一种文化现象。它被视为一个神秘而深奥的数字，代表着答案的本质或者存在的意义。然而，实际上，作者本人在书中明确表示42只是一个笑话，没有任何特殊含义。
<br/>因此，42的特别含义主要是来自于文学作品中的虚构元素，而非真实世界的事实或数学概念。
:::

呈现效果：

表格 3

语法	效果	其他注意事项
`:::tip`	高亮块类别 (预定类别包括：`tip, warn , danger, blutip, trans, muted, gpt, talk, tkpink` )	/
`@hide`	默认折叠收起高亮块	可缺省
`:"??"`	指定标题	可缺省，此时以 `Tip` ，`Warn` 等文本兜底

补充 - 更多语法方案

吾辈最初选定语法格式，即 ::: 来实现文本高亮块（admonition），很大程度沿袭了语雀笔记里的输入约定，此外，Docusaurus 也使用了此方案，

当然，更多的语法方案可参考该博文下的列举：在 Astro 添加 markdown 提示语法