MarkDown常用语法

---

Order: 4
Area: editor
TOCTitle: Markdown user note.
ContentId: 80f4fa1e-d4c5-42cf-8b12-4b8e88c41c3e
PageTitle: Markdown user note.
DateApproved: 2019/05/27
MetaDescription: Learn about Markdown use.

MarkDown 使用笔记

---

Markdown基本使用

内容目录使用

标题使用

标题分为六个等级，# to ######,#和文字说明之间使用空格隔开，eg:# 标题一。标题的下一行应该为空格。

eg: ## 标题二,### 标题三,#### 标题四,##### 标题五``###### 标题六

强调

斜体使用*文本*or_文本_。粗体使用**文本**or__文本__。

eg: 这是斜体，这是斜体、这是粗体，这是粗体

行内代码块

使用`code`表示行内代码块。
eg:main()函数

高亮

高亮使用==文本==来使用。
I am highlight code

上标、下标、脚注

上标使用^内容^，下标使用~内容~、脚注使用[^name]

eg: O³,H₂O
这是一个注脚¹的样例。

缩略

FPGA 即现场可编程门阵列.

删除线

这是一段错误的文本。

分隔线

分隔线可以使用***,---,___
eg

---

链接引用

使用如下格式<网址>。
https://www.baidu.com

外连接

使用 [描述](链接地址) 为文字增加外链接。
eg:本人博客;

插入图片

Markdown高级使用

区块引用

先断好行，然后在每行的最前面加上 >。或者只在段首添加：>。

eg:This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.

区块引用可以嵌套（例如：引用内的引用），只要根据层次加上不同数量的 >.

This is nested blockquote.

Back to the first level.

引用的区块内也可以使用其他的 Markdown 语法，包括标题、列表、代码区块等

这是一个标题。

1.这是第一行列表项。
2.这是第二行列表项。

给出一些例子代码：

return shell_exec("echo $input | $markdown_script");

列表

Markdown 支持有序列表和无序列表。

无序列表使用*作为列表标记：

• Red
  • red apple
    • good red apple
• Green
• Blue

有序列表使用 数字 + . 作为列表标记：

1. Red

   1. red apple
      1. good red apple.
   2. red man

2. Green

3. Blue

4. This is a list item with two paragraphs. Lorem ipsum dolor
   sit amet, consectetuer adipiscing elit. Aliquam hendrerit
   mi posuere lectus.

   Vestibulum enim wisi, viverra nec, fringilla in, laoreet

   vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
   sit amet velit.

5. Suspendisse id sem consectetuer libero luctus adipiscing.

表情符号（emoji）

? ? ? :fa-car: ✋ ? ? ?
参考链接地址:https://www.webfx.com/tools/emoji-cheat-sheet/
git提交emoji:https://github.com/liuchengxu/git-commit-emoji-cn

注意：需要设置 "markdown-preview-enhanced.enableEmojiSyntax": true

critic markup

我是一个{++ 好++}男孩。
我是一个{-- 好–}男孩。
我是一个{~~好_>坏~}男孩。
我是一个好男孩。{>>好是形容男孩的<<}
我是一个{== 好男孩==}。

注意：需要设置 "markdown-preview-enhanced.enableCriticMarkupSyntax": true，然后重启vscode。
详细使用请参考http://criticmarkup.com/users-guide.php

表格

姓名	性别	年龄	班级
张三	男	24	3.1
小明	男	25	3.1
小茗	女	23	3.2

>	时间(h)	任务
早晨	8-10	学习
^	11-12	看电视
下午	13-14	睡觉

注意: 在使用第二张表>,^时，需要开启vscode中的"markdown-preview-enhanced.enableExtendedTableSyntax": true

任务列表

• Cmd Markdown 开发
  • 改进 Cmd 渲染算法，使用局部渲染技术提高渲染效率
  • 支持以 PDF 格式导出文稿
  • 新增Todo列表功能 语法参考
  • 改进 LaTex 功能
    • 修复 LaTex 公式渲染问题
    • 新增 LaTex 公式编号功能 语法参考
• 七月旅行准备
  • 准备邮轮上需要携带的物品
  • 浏览日本免税店的物品
  • 购买蓝宝石公主号七月一日的船票

代码块

在代码的上边下边添加 ```。{.line-numbers}是强制说明显示行号。.highlight是要高亮的行。可以是单独某行高亮.highlight = 2，或者范围高亮.highlight= 1-2，也可以是多个范围.highlight=[1-2,5,10-12]。

#include <stdio.h>

void main(void)
{
    uint8_t sum = 0;
    for(uint8_t i = 0; i < 100; i ++)
    {
        sum += i;
    }
    pritnf("sum = %d\r\n",sum);
}

数学公式

默认分隔符 $表达式$表示行内显示表达式，$$表达式$$表示在块内显示表达式。
eg:$f(x)=sin(x)+12$
$$\sum _{n=1}^{100}{a}_i=0$$

更多使用参考连接.

导入文件

使用@import "file name"就可以导入文件。

@import “test.csv”;

图像

流程图(flow chars),流程图的介绍连接https://creately.com/diagram-type/objects/flowchart.

sequenceDiagram {theme="simple"}
Andrew->China: Says Hello
Note right of China: China thinks\nabout it
China-->Andrew: How are you?
Andrew->>China: I am good thanks!

wavedrom 是一款免费并且开源的在线数字时序（波形）渲染引擎，它使用javascript、HTML5和SVG将WaveJSON输入文本描述转换为SVG矢量图形。wavedrom githubhttps://github.com/wavedrom/wavedrom。官网地址https://wavedrom.com/

{signal: [
  {name: 'clk', wave: 'p.....|...'},
  {name: 'dat', wave: 'x.345x|=.x', data: ['head', 'body', 'tail', 'data']},
  {name: 'req', wave: '0.1..0|1.0'},
  {},
  {name: 'ack', wave: '1.....|01.'}
]}

Vega是一种可视化语法，是一种用于创建、保存和共享交互式可视化设计的声明性语言。使用Vega，您可以用JSON格式描述可视化的视觉外观和交互行为，并使用Canvas或SVG生成基于web的视图。vega官方地址https://vega.github.io/vega/

@import “./resource/vageWordMap.json” {as=“vega”}

code clumk

代码渲染，在线运行代码。

幻灯片设置

---

文档参考
1.Markdown Preview Enhanced
SVG生成基于web的视图。vega官方地址https://vega.github.io/vega/

@import “./resource/vageWordMap.json” {as=“vega”}

code clumk

代码渲染，在线运行代码。

幻灯片设置

---

文档参考
1.Markdown Preview Enhanced
2.十六进制颜色查询网站

关于技术交流

此处后的文字已经和题目内容无关，可以不看。
qq群:825695030
微信公众号:嵌入式的日常
如果上面的文章对你有用，欢迎打赏、点赞、评论。

---

1. 这是一个注脚的说明文本（此定义可以定义在文档的任何位置，一般放在文本结束）。 ↩︎