Markdown入门手册


Design by 寧

注: ①此中大部分操作都可以使用typora自带右键菜单进行操作。

​ ②Markdown兼容HTML。


部分扩展语法需要在设置中打开markdown扩展语法


一、块级元素

六级标题

# 标题一

## 标题二

### 标题三

#### 标题四

##### 标题五

###### 标题六

(在井号和后面的文本之间有一个空格相隔开,可以做到大小分级分配)

引用

引用

通过> 加文字进行引用,同样中间需要有空格隔开

> 内容

列表

①有序列表

(通过数字加小黑点加空格构成有序列表)

1. 内容

  1. 把大象放进冰箱

  2. 把大象塞进去

  3. 关上冰箱

②无序列表

(通过短横线 - 或者 * 加空格构成无序列表)

- 内容 或者 * 内容

  • 和平精英
  • 王者荣耀
  • 英雄联盟

③任务列表

(通过短横线 - 加方括号 [ ] 构成任务列表)

(注意:短横线和方括号之间有空格,方括号里有空格,后面也有,也就是每一个符号之间都有)

- [ ] 内容

  • 任务列表测试
  • 可以手动勾选前面的框表
  • 也可以通过用X把方括号里面的空格代替来勾选

代码块

(通过三个英文反引号 ``` 加编程语言名字开头,后接代码块,结束用三个反引号收尾)

```编程语言(代码块)```

(部分markdown编辑器可自动识别之后自动弹出代码块框架)

int main()
{
    return 0;
}

数学公式

(使用四个英文美元符号将公式括起来 $$$$ ,公式放在中间,行内为两个美元符号)

$$公式表达式$$

$\frac{1}{x}$

表格

(表头和结尾使用短杠 | 加名字)

|名字|

:--- :---: ---:

(对齐方式使用冒号 : 加短横线 - ,短横线至少要有一个,如果在左边表示左对齐,在右边右对齐,两边都有居中对齐)

姓名 年龄 成绩
王家宁 19 100

typora可以自动识别并处理此类数据

脚注

(通过方括号 [ ] 内嵌一个帽子符号 ^ 形成,注意全英文)

(下面的解释要在冒号后面加空格,冒号注意英文格式)

[^脚注]

[^对应脚注名字]: 解释

脚注

一键三连^三连

横线

(使用三个短横线构成横线)

---


二、行内元素

链接

①普通链接

(使用方括号 [ ] ,在里面写链接的名字,后接小括号 ( ) ,小括号内写链接的地址,注意使用全英文符号)

(链接地址后面可以用英文双引号写注释)

[百度](www.baidu.com"一个搜索引擎")

例如:百度

②引用链接

(在中括号后面再加一个中括号里面写入ID,然后在后面将ID解释)

[百度][id]

[id]: www.baidu.com "一个搜索引擎"

百度

优点:若需要多次更改,则只需要更改ID即可

③链接作为-目录-跳转-对应标题

(使用方括号 [ ] ,在里面写链接的名字,后接小括号 ( ) ,小括号内写#加标题的名字)

(在这里井号和标题名字之间不需要空格,且无论跳转标题是几级标题,都只能用一个井号)

(==在md文件中点击时需要用 Ctrl 加鼠标跳转==)

[跳转代码块](#代码块)

例如:跳转代码块

URL

(直接使用URL加冒号,注意英文)

URL: www.baidu.com

URL:http://www.baidu.com

图片

(英文感叹号 ! 加 方括号内有替代的文本,后面是英文括号,括号内有图片链接,同样可以英文双引号加说明文字)

(本体图片可以使用本地图片相对/绝对地址,相对地址是指相对于本文件所在的文件夹的路径,绝对地址是指在电脑上的绝对地址)

不做演示了。

! [图片演示](假设有个链接 "说明文字")

三、其他行内格式

强调型(可组合使用)

①一对星号表示斜体*内容*

斜体测试

②两对星号表示加粗**内容**

加粗测试

③三对星号则是斜体加粗***内容***

斜体加粗测试

④使用HTML里面的u标签下划线达成下划线效果<u>内容</u>

下划线测试

⑤文字高亮使用两对等号==内容==

​ ==高亮文字测试==

代码相关

行内代码使用一对英文反单引号``

printf("行内代码测试");

表情代码

格式:一个冒号 加上表情的名称再加上 一个冒号:smlie:

​ :smile::kissing_smiling_eyes::artificial_satellite:😄😄😄

(表情名称可以参考国际emoji通用代码,也可以直接复制过来)

网站:Emoji大全 | Emoji表情符号词典 📓 | EmojiAll中文官方网站

行内数学公式

使用一对美元符号

​ $\theta = x^3$

上、下标

上标:使用尖帽子符号,注意是前后各两个我^喜欢你^

​ 我^喜欢你^

下标:使用一对波浪号将其标记,同样是前后两个H~2~O

​ H2O


四、嵌入

①嵌入B站视频

以我所基于的B站学习视频为例,从分享中找到嵌入视频链接,复制到markdown编辑器中即可:


五、导出

插件Pandoc

在日常使用过程中,需要用到其他的格式,typora默认支持.md文件转.pdf.html格式,其余的常见格式需要使用pandoc扩展程序来支持。

在导出界面可以看到,typora本身支持的导出格式在横线之上。

而当点击其他格式时,会提示安装pandoc扩展文件。

①下载pandoc扩展程序

进入pandoc官网,点击下载适合自己操作系统的版本

下载过程中,可能遇到下载失败,连接超时等情况,原因为:此官网为美国服务器,可能数据连接被墙,可自行想办法解决。

②点击安装程序

点击pandoc-2.19-windows-x86_64.msi安装程序。(程序版本号根据自己所下载的版本定)

安装程序

选取第一个选项,第二个选项将需要获取管理员权限,点击安装。

安装为默认选项,没有可修改项,安装默认到C盘。

默认安装

③配置环境变量

安装完毕后,记得配置==环境变量==:

将安装目录放置于path中,默认安装会自动将路径配置到path中,如果有用户配置的path,则需要手动将其添加到系统path中。

配置环境变量

④检测安装是否成功

运行cmd输入pandoc --help如果安装不成功,将提示pandoc不是系统程序。安装成功,将出现帮助项

检测是否安装成功

⑤使用typora导出

在安装完pandoc之后,可使用typora的导出功能。

注:可能存在安装完之后,还是提示安装pandoc,此时可重新启动电脑,或者卸载typora,然后再安装。

完成上述操作之后,将可以方便的使用pandoc的.md转其他格式。

使用插件导出

typora将自动调用pandoc,并在后台静默操作。

⑥Pandoc使用

pandoc是一个很强大的文件转换工具,以上只阐述了使用typora来讲md文件导出为其他格式。
详细的pandoc转换方式,可以自行查看pandoc的帮助文档。

六、注意事项

①Pandoc导出word错误

如果安装了pandoc,显示: couldn’t read native导出失败提示

原因:==由于原文档中包含表格,导出word格式不成立==。
方法1:删掉表格,导出后手动加入到文档。
方法2
①在.md文档所在目录打开cmd终端;
②输入:

pandoc -s 原文档名字.md -o 新名字.docx

改名字导出

回车即可。

注:此二种方法均为于CSDN查阅。

相关网址:(33条消息) Typora导出word失败_奔跑的小仙女的博客-CSDN博客_typora导出word失败


文章作者: 王家宁
版权声明: 本博客所有文章除特別声明外,均采用 CC BY 4.0 许可协议。转载请注明来源 王家宁 !
  目录