炒鸡好用的Markdown语法

news/2024/11/15 2:01:19/文章来源:https://www.cnblogs.com/skmcj/p/18353543

简介

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. 天上的星星统称 ↩︎

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.hqwc.cn/news/781308.html

如若内容造成侵权/违法违规/事实不符,请联系编程知识网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

Arweave区块链私有化部署

Arweave区块链私有化部署Arweave区块链主打数据永久存储,即保存在区块链的数据永久存在、不可篡改。公链主网络arweave.N.1在2024年8月11日累计产生了148万个区块(见下截图所示),区块还在不断产生,大约2分钟产生一个区块。Arweave区块链可以在Ubuntu 22.04LTS或Ubuntu 24.04…

多线程复习总结

1基本概念 1什么是进程什么是线程 进程:是程序执行一次的过程,他是动态的概念,是资源分配的基本单位。一个应用程序(1个进程是一个软件)。 线程:一个进程可以有多个线程,线程是cpu调度的单位,一个进程中的执行场景/执行单元。 对于java程序来说,当在DOS命令窗口中输入…

kubernetes-POD的基本原理

目录什么是POD?POD有以下特点:为什么使用POD作为最小单元,而不是container为什么允许一个POD里有多个容器POD中如何管理多个容器POD的yaml格式定义配置文件说明如何使用PodPOD的持久性和终止Pause我们首先在节点上运行一个pause容器然后再运行一个nginx容器,nginx将为localh…

【投资认知】- 2024Q1的英伟达NVIDIA

来自关注的Twitter博主@ZeevyInvesting 💡 Investing visuals | 📜 One-pager analysis | 📈 Tech portfolio updates | 🥊 Business Battles来源:https://twitter.com/ZeevyInvesting/status/1801691822705512947名词解释CAGR:复合年增长率(Compound Annual Grow…

【1.0版】【MYSQL安全】sql注入系列:基于报错的 SQL 盲注

主题 sql注入:基于报错的 SQL 盲注一、Floor报错注入1.1 floor 函数1.2 rand函数 1.3 count(*) 1.4 floor函数实际利用二、extractvalue函数三、updatexml函数:同extractvalue本来网页是不显示信息的,但是我们可以构造 payload 让信息通过错误提示回显出来一、Floor报错注入…

CISC和RISC

CISC的特点RISC的特点CISC和RISC的比较如何分辨CISC和RISCCISC的指令不定长,RISC的指令都是定长的 RISC中只有Load\Store类指令可以访问主存

P1502 窗口的星星 题解

题目传送门。 思路 扫描线 扫描线 首先,将题目中给出的条件和问题进行转化: 首先先不考虑边框上的点不算在内的限制,考虑一个点可以对那些矩形产生贡献。 只考虑矩形的右上角,容易发现,每个星星的亮度只对右上角在以星星为左下角的长为 \(W\),高为 \(H\)的矩形有贡献。 如…

bugbountyhunter scope BARKER:第7滴血 存储型 XSS 编码测试和多处引用 报告

注册后,来到UI Display Name处直接点击更新之后,发现反射值的存在尝试一些编码,发现没有任何转换。编码测试更简单,语义一把梭:比如各种华丽花哨的编码到落地并没有被还原成 <>"等语义,此处没有漏洞 https://github.com/swisskyrepo/PayloadsAllTheThings/tre…

centos7中安装了centos-release-scl后,之前的yum源变为不可用 解决方案

centos7中安装了centos-release-scl后,之前的yum源变为不可用 解决方案 1. 前言 今天遇到了一个奇奇怪怪的事情,我自己在自己的服务器(centos7)上安装了centos-release-scl后,之前运行正常的yum命令竟然变得不可用。 2. 场景重现 执行下面这条命令后,再次使用yum报错。 yum …

grpc-gateway:grpc转换为http协议对外提供服务

使用grpc的优点很多,二进制的数据可以加快传输速度,基于http2的多路复用可以减少服务之间的连接次数,和函数一样的调用方式也有效的提升了开发效率。 不过使用grpc也会面临一个问题,我们的微服务对外一定是要提供Restful接口的,如果内部调用使用grpc,在某些情况下要同时提…

PostgreSQL的查询详解

PostgreSQL的查询详解 1. 表表达式 表表达式计算一个表。该表表达式包含一个 FROM 子句,该子句后面可以根据需要选用 WHERE、GROUP BY 和 HAVING 子句。最简单的表表达式只是引用磁盘上的一个表,一个所谓的基本表,但是我们可以用更复杂的表表达式以多种方法修改或组合基本表…