首页 > 其他分享 >炒鸡好用的Markdown语法

炒鸡好用的Markdown语法

时间:2024-08-11 16:17:51浏览次数:13  
标签:Markdown 斜体 预览 子项 语法 内容 炒鸡

简介

Markdown是一种轻量级标记语言,它最初由John GruberAaron Swartz2004年共同创建,可以通过简单、纯文本的语法,快速构建格式化、排版精美的文档。其可与HTML混编,可导出为HTMLPDFWord等格式的文件

Markdown可以让作者更多地关注内容本身而非格式排版。同样的内容,在Markdown里会比在WordHTML等里容易很多

  • 如:定义一段粗体文字
    • Word中,我们需要选中这段文字,然后选中粗体格式,或快捷键ctrl+B
    • HTML中,我们需要用strongb标签包裹,或用CSS设置
    • 而在Markdown中,我们只需要在两侧用两个星号**包裹即可

得益于其简洁、高效、易读、易写,Markdown被大量使用。如GitHub、Jupyter Notebook和各种博客平台,都原生支持Markdown,可以说是技术文档编写的首选,甚至可以用来帮助写公众号文章(本篇推文即用Markdown编写)

使用

Markdown文件通常采用.md的后缀,其可以在几乎所有文本编辑器中打开编辑,如:电脑自带的记事本等

但,如果你想要预览其排版格式化的内容,则需要使用对应支持的编辑器,好用的编辑器可以帮你快速预览、导出各种格式的文档或图像等,下面介绍几款主流好用的编辑器

  • Typora — 可实时预览,界面简洁,支持多种格式导出,可自由导入、切换、自定义各种主题
  • VSCode — 了解的应该都了解,搭配扩展,可实现Markdown的预览编写
  • Obsidian — 一款功能强大的笔记软件,以双向链接和知识图谱为特色,适合笔记和知识管理
  • StackEdit — 功能强大的在线编辑器,可同步到Google DriveDropbox

基础语法

千万不要被标记语言吓到,Markdown的语法十分简单,常用的标记符号不超过十个,用于日常写作记录绰绰有余,几乎不到半小时就能完全掌握,从此达到心中无尘,码字入神的境界

标题

用于创建1-6级的标题,可对应HTMLh1 - h6

#后加一个空格再跟标题内容的语法创建,#的数量于标题级数成正比,几级标题前就跟几个#

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

对应预览效果(不同编辑器、主题会呈现不同效果,可自定义,本文采用github主题):

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

段落

创建段落,只需使用空白行一行或多行文本进行分隔

这是第一段文本内容

这是第二段文本内容

预览:

这是第一段文本内容

这是第二段文本内容

如果段落含有语法字符,可使用\转义,如\*转义而非斜体\*

词汇语法

强调

可将文本设置为粗体斜体来强调其重要性

  • 粗体

    需要加粗文本,只需在待加粗内容前后两侧分别添加*星号或_下划线,推荐使用星号

**两个星号加粗**

__两个下划线加粗__

预览:

两个星号加粗

两个下划线加粗

  • 斜体

    需要斜体显示文本,只需在待斜体内容前后两侧分别添加*星号或_下划线,推荐使用星号

*一个星号斜体*

_一个下划线斜体_

预览:

一个星号斜体

一个下划线斜体

如果想要同时粗体和斜体,只需在待格式内容前后两侧各添加*星号或_下划线,推荐使用星号

***同时粗体和斜体内容***

___同时粗体和斜体内容___

预览:

同时粗体和斜体内容

同时粗体和斜体内容

删除线

想要出现删除线效果,只需在待删除内容前后两侧各加~

~~删除线内容~~

预览:

删除内容

高亮

想要高亮内容,只需在待高亮内容前后两侧各加=

==高亮内容==

预览:

高亮内容

上下标

有时需要使用上下标格式文本

  • 上标

    使用上标,需在待上标内容两侧加^

x^y^

预览

xy

  • 下标

    使用下标,需在待下标内容两侧加~

H~2~O

预览

H2O

链接

可用于快速插入链接,达到跟HTMLa标签同样的效果

语法为:[链接描述](链接地址)

[百度一下](https://www.baidu.com)

预览:

百度一下

图片

可用于快速插入图片,达到跟HTMLimg标签同样的效果

语法为:![图片描述](图片链接地址,可本地或网络),与链接语法类似,前面多了个!而已

![可为空](D:\img\cat.gif)

预览:

cat

引用

用于创建块引用,达到突出引用内容的目的

语法为:> 引用内容,采用>后跟一个空格再加待引用内容的形式

如有多段引用内容,需要在每一段内容前均添加>,包括分隔段落用的空白行

> 单行引用内容

> 多行引用内容
> 
> 第二段内容

预览:

单行引用内容

多行引用内容

第二段内容

引用还可以嵌套结合其它语法进行使用,如强调、链接、列表等,具体可自行尝试

分隔线

在单独一行上使用三个或多个星号 ***、破折号--- 或下划线 ___,并且不包含其他内容,可创建一条分隔线

***

---

_________________

预览(三种方式效果一致)


列表

用于将多个条目组织成有序或无序列表

  • 无序列表

    在每个列表项前面添加破折号-、星号*或加号+(用空格隔开),缩进一个或多个列表项可创建嵌套列表

- 第一项
  - 第一子项
- 第二项
  - 第二子项
    - 子子项
- 第三项

预览:

  • 第一项

    • 第一子项
  • 第二项

    • 第二子项
      • 子子项
  • 第三项

  • 有序列表

    在每个列表项前添加数字并紧跟一个英文句点(用空格隔开),数字不必按数学顺序排列,但是列表会当以数字1起始

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

预览:

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

代码

可将短语或单词表示为代码,两侧各使用一个引号`包裹

如果想在代码内含有反引号,可在内容两侧使用个反引号`包裹

JS可使用`console.log`输出内容到控制台

输出反引号``console.log('`')``

预览:

JS可使用console.log输出内容到控制台

输出反引号console.log('`')

代码块

用于表示一整段代码内容,语法如下,用三个反引号```或三个波浪号~~~包裹块内容

```json
{
	"id": 4001037,
	"name": "skmcj"
}
```

```java
System.out.println("hello world");
```

预览:

{
	"id": 4001037,
	"name": "skmcj"
}
System.out.println("hello world");

反引号后可跟内容块语法的标注名称,可起到语法高亮效果,也可不跟内容,表示普通纯文本

内嵌HTML

有时候,单纯的Markdown并不能满足我们的全部需求,此时可直接使用HTML标签表达

<span><cite><del><a><img><div>等标签,同时可搭配一些简单的属性样式,起到改变文字、图片大小等效果

高级语法

基础语法用于应对大部分日常场景已经十分够用,但对于某些场景仍有一些不够

表格

使用三个或多个连字符---创建分隔标题与内容块,并使用管道|分隔每列,可以选择在表的任一端添加管道

| 第一列      | 第二列 |
| ---------- | ----- |
| 内容        | 内容  |
| 内容        | 内容  |

预览:

第一列 第二列
内容 内容
内容 内容

默认是采用左对齐,可在分隔行两侧添加冒号:表示左对齐、右对齐或居中

| 左对齐  | 居中  | 右对齐 |
| :----- | :--: | -----: |
| 内容    | 内容  |   内容 |
| 内容    | 内容  |   内容 |

预览:

左对齐 居中 右对齐
内容 内容 内容
内容 内容 内容

任务列表

在列表项前带有复选框,用于表达任务的完成与否

语法参考:在任务列表项之前添加破折号-和方括号[ ](两者用空格隔开),选择复选框,需在方括号[]里面添加·x,如[x]

- [ ] 任务一,未完成
- [x] 任务二,已完成

预览:

脚注

可以为内容添加注释和参考

  • 脚注使用[^1]: 注释一内容的形式定义,[^1]为脚注标识,^后可跟数字或单词(这里为数字1),脚注内容标识之间用冒号加空格隔开
  • 引用脚注只需在内容后加脚注标识即可[^1]
危楼[^1]高百尺[^2],手可摘星辰[^3]。

[^1]: 高楼,这里指山顶的寺庙
[^2]: 虚指,不是实数,这里形容楼很高
[^3]: 天上的星星统称

预览:

危楼[1]高百尺[2],手可摘星辰[3]

最后

除了本文介绍内容,Markdown还可以扩展流程图图表数学公式等语法,感兴趣可自行深入了解

同时,搭配不同主题还可以生成各种精美格式、以下是一个拟态风的自定义主题预览

cover


  1. 高楼,这里指山顶的寺庙 ↩︎

  2. 虚指,不是实数,这里形容楼很高 ↩︎

  3. 天上的星星统称 ↩︎

标签:Markdown,斜体,预览,子项,语法,内容,炒鸡
From: https://www.cnblogs.com/skmcj/p/18353543

相关文章

  • Markdown使用入门(3分钟学会)
    MarkDown语法基础入门(1分钟学习及速查)标题:‘#’空格:一级标题‘##’空格:二级标题字体**粗体***斜体*~~删除线~~引用>空格分割线三条杠---三个***图片![名称](url)超链接点击跳转[连接名称](地址)列表有序号:1.输入完加空格无序:-加空格......
  • Wfurent 语语法概述
    \[\textit{Litar!}\newcommand{\wd}[2]{\texttt{#1}^{#2}}\]让神明白  文字产生于史前的祭祀,史前的人们改造了原式的语言规则,使得句子拥有“唯一语义性”(至少保证语法树可被唯一生成),以清晰(而不那么像人话)地传递对神的祈求。后来人们逐渐适应了改造语言,产生了系统的Wfurent......
  • 递归下降语法分析
    递归下降本质递归下降使用递归推导方式来解析语法,其要求文法能够使用递归方法追个推导,最终达到文法匹配的目的。例如如下计算逻辑表达式的BNF文法: <expr>::=<term><expr_tail> <expr_tail>::='&'<term><expr_tail> |'|'<term><expr_t......
  • C-10-快速语法参考-全-
    C#10快速语法参考(全)原文:C#10QuickSyntaxReference协议:CCBY-NC-SA4.0一、你好世界选择IDE要开始用C#编码,你需要一个支持.NET的集成开发环境(IDE),最流行的选择是微软自己的VisualStudio。122自2002年C#1.0首次发布以来,C#语言经历了多次更新。在撰写本......
  • 011.Vue3入门,计算属性的使用,让模板语法更简洁
    1、代码如下:<template><h3>计算属性</h3><div>{{func1}}</div><div>{{func1}}</div><div>{{func1}}</div><!--<div>{{func1()}}</div>--><!--<div>{{func1()}}&......
  • 002.Vue3入门,使用模板语法的一些高级功能
    1、代码如下:<template><h3>模板语法</h3><p>{{msg}}</p><p>{{msg_cn}}</p><p>{{number+1}}</p><p>{{ok?'Yes':'No'}}</p><p>{{message.split("......
  • R语言用户自定义函数的语法结构、编写自定义统计值计算函数(使用ifelse结构计算均值和
    R语言用户自定义函数的语法结构、编写自定义统计值计算函数(使用ifelse结构计算均值和标准差等)、编写自定义日期格式化(format)函数(switch函数使用不同分枝格式化日期数据)、应用自定函数目录R语言用户自定义函数的语法结构、编写自定义统计值计算函数(使用ifelse结构计算均值和......
  • 【SD教程】超详细AI绘画提示词语法讲解!
    前言一、SD提示词基础AI绘画提示词基本规则1、提示词(prompt)由多个词缀构成。提示词分为正向提示词(positiveprompt)和反向提示词(negativeprompt),用来告诉AI哪些需要,哪些不需要。2、词缀的权重默认值都是1,从左到右依次减弱,权重会影响画面生成结果。比如景色Tag在前,人物......
  • MATLAB基础语法
    学习材料b站:0零基础入门matlab教程基础版最后图像导出值得一看up主很多知识都没有讲清楚,也遗漏了很多点;没有强调代码的规范性,何时加;一头雾水;他自己没有重视教程的录制优点是短,可以快速上手,官方文档是很好的伙伴matlab帮助文档thysrael的博客界面认识clc清除终......
  • Java基础语法:变量与数据类型
    变量1.概念:变量是用来存储数据的命名容器并在程序的不同部分使用它。2.语法:数据类型变量名称=初始值;可以这样理解:**数据类型:**鱼缸**变量名称:**鱼的名字**变量的值:**鱼缸里装的鱼或数量数量数据类型基本数据类型-整型:1.byte:8位,有符号整数(-128到127)2.short:......