Skip to content

markdown语法

markdown语法

image-20231021102012091

目录

[toc]

前言

1.Markdown 是什么

Markdown 是一种轻量级标记语言,创始人为约翰·格鲁伯(John Gruber)。它允许人们「使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档 」—— 维基百科

如果你看不懂以上维基百科对 Markdown 的定义,就当这段掐了没播。约翰·格鲁伯自己对Markdown的描述的重点也在于 「easy-to-read,easy-to-write」。

2.那么到底 easy 在哪里呢

虽然称作 「标记语言」,但简单理解 Markdown 就是在文本前增加符号来表示文本格式。你不需要关心标题多大号,列表缩进多少,是否对齐,只要使用了同一种符号标记,Markdown 已经帮你做好了排版。

无图无真相: image-20211125161126505

3.Markdown 的好处

  1. 编辑,不用操心排版你只需要把注意力放在内容上。笔者在用 Markdown 之前,打开word 先想想,标题用啥字体呢,几号字呢?不知不觉我的意志力就被消耗了。实际上所谓排版,不就是作者的思路以及内容的层级和结构么,在学会使用 Markdown 之后,几个简单的符号就把这些事儿搞定,样式还特别工整精美。

  2. 修改,不用担心排版想想那些你在同事之间改来改去的 word 文档吧,如果哪位童鞋从外部粘贴了一段带格式的文字,那么你再次打开文档时会发现整个人都不好了:格式被改的乱七八糟,还要重新调整。如果用 Markdown 群组笔记 ,想改哪里改哪里,根本不用担心格式,改完评论里直接 @TA,多轻松!(排版都是可复制的;文字的排版只是多打几个符号而已,最终产出的只是一个纯文本,非常利于传播和迁移。所以 Markdown 才是程序员的最爱。)

    注意:一般像微信文章,博客文章等技术文章,都是可以直接复制粘贴到md文件里的,会自带markdown格式的

一句话来说,Markdown 是用最简单的方式,零排版成本,写出布局工整、阅读舒适的笔记。减少干扰,降低成本,提高效率,不管在什么设备上,看起来都是一个工整的样子。不仅自己阅读爽,分享给朋友也有面儿不是~

4.哪些牛人都在用

  • 阳志平在 2012 年就发博客推崇了一下 Markdown,但那篇文章虽解读深刻,但也略显极客,把Markdown 不仅能排版,能做流程图,还支持数学公式的特性介绍了一遍,连科技论文都要选择 Markdown都涉猎到了。有兴趣阅读的童鞋可点击这里注意:这个链接目前打不开了。。)查看。

  • 很多在线博客和内容社区都提供 Markdown 编辑器,不仅在阅读上带来了舒适、统一、美好的体验,每一个参与写作的人,也能够毫不费力地写出排版整齐的文章来。

  • 我遇到的很多运维大佬也是采用这个typora来作为课件使用来着的!

来个小技巧

不管我再怎么说 Markdown 的语法记忆负担小、简单,在最初你都会有点儿晕。在这里给大家分享个小技巧:

  1. 最初只需要记住 # 标题一## 标题二1. 第一点*这一点,用这几个写写日志、需求文档、小文章,排版上足够了;
  2. 逐渐的你发现有些文字需要重点指出,那么还可以使用 **加粗***斜体*来对文字做重点说明;
  3. 如果你是名程序员,那么可以用 ```` 把代码块包起来,**渲染后可以关键字高亮**(666),用 >` 可以做引用 ;

1.标题

  • Typora快捷键

    • Ctrl/Cmd + 数字 (数字可以是1到6分别代表不同级标题)、

    • 提升标题级别:ctrl +

    • 降低标题级别:ctrl -

  • markdown语法:

    • 语法格式:#+空格+标题,一个#是一级标题,两个##是两级标题,以此类推,支持六级标题

2. 列表

🍀 有序列表

  • **Typora快捷键:**ctrl shift [
  • markdown语法:

在行首增加 1.、2.、3.,即数字和英文句点, 注意句点与文字中间有空格。不要求数字一定要连续,可以都是1.

\1. 有序列表

\1. 有序列表

\4. 有序列表

点击保存后的效果:

  1. 有序列表
  2. 有序列表
  3. 有序列表

**备注:**直接在文字前面按回车后,是可以自动排序的;(无序列表也是一样的)

🍀 无序列表

  • **Typora快捷键:**ctrl shift ]
  • markdown语法:

在行首增加 * 或 -或+与文字之间有空格

* 无序列表

- 无序列表

+ 无序列表

点击保存后的效果:

  • 无序列表
  • 无序列表

🍀 子列表

在子列表前按下tab键即可构成子列表。

3. 图片

  • **Typora快捷键:**ctrl+shift+i
  • markdown语法:

语法格式:![alt](../../../../BaiduSyncdisk/1、IT/5、Other/图片地址 ''title'')

alt 指的是当图片链接失效时显示的提示文字,可加可不加

title是图片的标题,当鼠标移到图片上时显示的内容,可加可不加

可直接粘贴图片,或将图片文件拖动到光标处。

也可以使用标准的Markdown语法,如:

img

如果你想要调整图片大小,有两种方式:

右击图片,选择缩放图片后,语法格式将变成<img src="../../../../BaiduSyncdisk/1、IT/5、Other/Typora.assets/32.jpg" alt="32" style="zoom: 20%;" />,20%可自行调整 通过HTML调节,格式如下:

bash
<center>
    <img style="border-radius: 20px;"
         src="Typora.assets/baymax.jpg" 
         alt="baymax"
         width="688" >
</center>
<center>标签设置图片居中对齐
  • border-radius设置圆角
  • src放置图片路径(本地路径或网络路径)
  • alt放置图片链接失效后的显示文字
  • width设置图片宽度(witdh和height只设置一个即可,等比例缩放)

你也可以通过如下代码为图片添加图注:

bash
<center>
    <img style="border-radius: 20px;"
         src="" 
         alt=""
         width="688" >
    <br>
    <div style="color: #999; padding: 2px;">
        图注
    </div>
</center>

Hello,I'm baymax,your healthcare companion.

🍀 图片插入

插入图片除了使用插入语句外,还可以:

  • ctrl+C/V 将网络图片、剪贴板图片复制到文档中
  • 拖动本地图片到文档中

Typora 会自动帮你插入符合 Markdown 语法的图片语句,并给它添加alt。

4. 超链接

  • **Typora快捷键:**Ctrl/Cmd + K
  • markdown语法:

`` ,例如:为知笔记,注意要使用英文符号

点击保存后的效果:

为知笔记

5. 字体

粗体、斜体、删除线、下划线

  • Typora快捷键:

    • 加粗: Ctrl/Cmd + B

    • 斜体:ctrl + i

    • 删除线:alt+shift+5

    • 下划线:ctrl + u

  • markdown语法:

粗体:在文字前后添加 ** (注意符号与文字间不要有空格)

斜体:在文字前后添加 *

删除线:在文字前后添加 ~~

下划线:ctrl + u

高亮:== 高亮 ==

plain
1. **粗体**
 2. *斜体*
 3. ~~删除线~~
 4. 下划线

保存后的效果:

粗体

斜体

删除线

下划线

6. 引用

  • Typora快捷键:
  • markdown语法:

在文字前 添加 >

点击保存后的效果:

如果你无法简洁的表达你的想法,那只说明你还不够了解它。 -- 阿尔伯特·爱因斯坦

🍀 引用也可以嵌套:

如加两个>>

三个>>>

支持无线套娃~~

test。

test。

7. 表格

  • **Typora快捷键:**插入表格:ctrl T

    • 下方插入行:ctrl enter

    • 上移该行:alt 向上箭头

    • 下移该行:alt 向下箭头

    • 左移该行:alt 向左箭头

    • 右移该行:alt 向右箭头

  • markdown语法:

  1. | 为知笔记|更新 | 版本 |
  2. |------------|-----------|--------|
  3. | WizNote | Markdown| Latest |

点击保存后的效果:

为知笔记更新版本
WizNoteMarkdownLatest

8. 代码

  • **Typora快捷键:**如下。

ctrl shift K

  • markdown语法:

先输入 三个反单引号:```,然后直接回车,就会弹出代码框了:

plain
int i =0;i =1;for (int i =0;i <100;i++){printf("hello markdown!\n");}

如果需要指定语言, 在开头的3个反向单引号 后紧跟具体语言即可,如:```bash (注意,这个功能很实用!!!)

yum install -y sl

或者按ctrl shift K即可弹出代码框:

啦啦啦

9. 目录

在任何你想要展示Markdown 笔记目录的地方,添加 [TOC], 在阅读模式下,标题1~6样式的内容会被提取出来作为目录,相当于大纲功能。

例如:

img

10.首行缩进

这个是什么东东哦……🤣

在需要缩进的地方加如下2个字符:

爱一个人真的很痛!

真的很难忘记你。

11.分割线

  • Typora快捷键:
  • markdown语法:

连续输入3个+或-号,回车即可插入一个分割线:

效果如下:


12.代办清单

-[x] 已完成项目1

-[x] 已完成项目2

- [ ] 代办项目1 #快捷键:ctrl shift

- [ ] 代办项目2

效果如下:

  • 已完成
  • 待完成

13.Typora其他快捷键

  1. 插入公式块:ctrl shift M

  2. 清除样式:ctrl \⚠️ 还可以把链接这种格式直接给清除了的!

  3. 粘贴为纯文本:ctrl shift v (常用)

  4. 撤销: Ctrl/Cmd + Z

  5. 显示/隐藏侧边栏:ctrl + shift + L,等价于ctrl + shift + 1 (这个是要放在编辑区域才会生效的。)

  6. 搜索:ctrl+f

  7. 源代码模式:ctrl+/(很少使用)

  8. 切换全屏:F11 #再次按F11就可以退出全屏模式了;

  9. 放大、缩小、还原:

    • 放大:ctrl + shift + =

    • 缩小:ctrl + shift + -

    • 还原:ctrl + shift + =9

  10. 应用内窗口切换:ctrl + Tab

  11. 开发者工具:shift + F12 *(常用)

  12. 表情和符号:windows + 句号

  13. 插入本地图片:ctrl shift insert

imgimg

  1. other
  • 建议平常写作时,使用快捷键,使用快捷键,使用快捷键,语法了解即可。
  • 注意:Typora快捷键可以在菜单里查看:

img

  • 转义

Markdown 使用了很多特殊符号来表示特定的意义,如果需要显示特定的符号则需要使用转义字符,Markdown 使用反斜杠转义特殊字符:

\ 反斜线

` 反引号

*星号

_ 下划线

{} 花括号

[] 方括号

() 小括号

# 井字号

+ 加号

- 减号

. 英文句点

!感叹号

  • 行内公式(inline)用 括起公式,公式会出现在行内。
  • 块间公式(display)用括起公式(注意 $$ 后需要换行),公式会默认显示在行中间。

对比图片地址

img

FAQ

html形式的表格

更新于:2023年10月21日10:19:04

image-20231021101843706

image-20231021101857894

🚩

案例:表格形式

记录时间:2023年8月21日

typora里呈现的是表格形式:

img

但其实是html代码:

img

把这段html代码放到其他md软件里,也会呈现为表格的形式:

img

关于我

我的博客主旨:

  • 排版美观,语言精炼;
  • 文档即手册,步骤明细,拒绝埋坑,提供源码;
  • 本人实战文档都是亲测成功的,各位小伙伴在实际操作过程中如有什么疑问,可随时联系本人帮您解决问题,让我们一起进步!

🍀 微信二维码 x2675263825 (舍得), qq:2675263825。

image-20230107215114763

🍀 微信公众号 《云原生架构师实战》

image-20230107215126971

🍀 个人博客站点

http:t="1711730357270" class="icon" viewBox="0 0 1024 1024" version="1.1" xmlns="http://www.w3.org/2000/svg" p-id="4392" width="16" height="16" >打赏支持