Question

4.1 markdown 语法

Markdown 是一种轻量级的标记语言，用于格式化纯文本。它常用于撰写文档、博客文章、说明文件等。以下是 Markdown 的基本语法，包括常见的格式和用法示例：

1. 标题

Markdown 使用 # 符号来创建标题。 # 的数量决定了标题的级别：

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

2. 段落

段落通过在文本之间插入一个空行来分隔：

这是第一段。

这是第二段。

3. 强调

• 粗体 使用两个星号或下划线：

  **这是粗体文本**
  __这是粗体文本__
  

• 斜体 使用一个星号或下划线：

  *这是斜体文本*
  _这是斜体文本_
  

4. 列表

• 无序列表使用星号、加号或减号：

  - 项目一
  - 项目二
    - 子项目一
    - 子项目二
  

  或

  + 项目一
  + 项目二
    + 子项目一
    + 子项目二
  

  或

  * 项目一
  * 项目二
    * 子项目一
    * 子项目二
  

• 有序列表使用数字和点：

  1. 第一项
  2. 第二项
     1. 子项一
     2. 子项二
  

5. 链接

• 内联链接：

  [链接文本](http://example.com)
  

• 引用式链接：

  [链接文本][1]
  
  [1]: http://example.com
  

6. 图片

• 插入图片的语法类似于链接，但前面有一个感叹号：

  ![替代文本](http://example.com/image.jpg)
  

7. 代码

• 行内代码使用单个反引号：

  `代码`
  

• 代码块使用三个反引号：

  \```
  代码块
  \```
  

  也可以指定语言来启用语法高亮：

  ```python
  def hello():
      print("Hello, World!")
  

8. 引用

• 使用 > 符号创建引用块：

  > 这是一个引用块。
  > 
  > 这是同一个引用块中的另一段文字。
  

9. 分隔线

• 使用三个或更多的星号、减号或下划线：

  ***
  ---
  
  ____
  

10. 表格

• 表格使用管道符 | 和破折号 - ：

  | 头部一 | 头部二 |
  |--------|--------|
  | 单元格 1 | 单元格 2 |
  | 单元格 3 | 单元格 4 |
  

11. 任务列表

• 任务列表使用方括号和空格来表示任务的完成状态：

  - [ ] 任务未完成
  - [x] 任务已完成
  

这些是 Markdown 的基本语法。Markdown 的简洁性和易读性使其成为撰写和格式化文本的流行选择。根据使用的 Markdown 渲染器或平台，可能会有一些扩展或额外的功能。

4.1.1 图片

很明显地，要在纯文字应用中设计一个「自然」的语法来插入图片是有一定难度的。

Markdown 使用一种和链接很相似的语法来标记图片，同样也允许两种样式： 行内式和参考式。

行内式的图片语法看起来像是：

• ![Alt text](/path/to/img.jpg)
• ![Alt text](/path/to/img.jpg "Optional title")

详细叙述如下：

一个惊叹号 !

• 接着一个方括号，里面放上图片的替代文字
• 接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上 选择性的 'title' 文字。

参考式的图片语法则长得像这样：

• ![Alt text][id] 说明： 「id」 是图片参考的名称，图片参考的定义方式则和连结参考一样：
  * [id] : url/to/image "Optional title attribute"

到目前为止， Markdown 还没有办法指定图片的宽高，如果你需要的话，你可以使用普通的 标签。

4.2 Liquid 模板语言

Liquid 模板语言

{{ 变量名 }}

示例：

// 文件名 setup，在 JB 目录下
{% assign BLOG_IMG = "/blog/" %}
//使用：包含文件名，调用变量
{% include JB/setup %}

![原始排序]({{BLOG_IMG}}anchor_getanchor.png)