Markdown语法教程笔记

Intro && 前言

本文为博主为方便个人学习查询markdown语法而写的笔记类型文章,可能不够系统,但会重点整理一些常用的或容易忘的md语法。

markdown官方中文教程:https://markdown.com.cn/basic-syntax/

先引用一段官方教程的Intro~

Markdown是一种轻量级标记语言,排版语法简洁,让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档,可与HTML混编,可导出 HTML、PDF 以及本身的 .md 格式的文件。因简洁、高效、易读、易写,Markdown被大量使用,如Github、Wikipedia、简书等。
千万不要被「标记」、「语言」吓到,Markdown的语法十分简单,常用的标记符号不超过十个,用于日常写作记录绰绰有余,不到半小时就能完全掌握。
就是这十个不到的标记符号,却能让人优雅地沉浸式记录,专注内容而不是纠结排版,达到「心中无尘,码字入神」的境界。

标题语法

个人最常用的语法,没有之一,一个’#’足够用了,最多可以起六级标题。

段落语法

创建段落需要用空行将上下文隔开,也就是打两次换行!

换行语法

this is the first line.
this is the sec line.

this is the sec paragraph.

换行时上下文的行距是不变的,而换段落是要增加行距的,如上文所示。
要想换行(Line Break),需要在一行的末尾添加两个或多个空格,然后按回车键

强调语法

加粗

两个星号Bold

斜体

一个星号Italic

又粗又斜请加三个星号

引用语法

在段落前加一个>号,可引用本段落

this is a quoted paragraph
this is the same para

this is another para

如果要将多个段落引用在一个块里,就在每个段落前都加一个>,并且它们之间的空行也要加>。

this is the first para

this is the sec para
this is the sec line of sec para

列表语法

有序列表

在每条item前面加数字和英文句点

  1. this is point 1
  2. this is point 2
  3. this is point 4

无序列表

在每个item前面加短横线(-)和空格

  • first item
  • second item

以上两种列表均可嵌套。

代码语法

要将单词或短语表示为一行代码,请将其包裹在反引号 (`) 中。

Here is my first code -> printf("Hello World!");

要创建一个代码块,需要将段落整体缩进一个tab,代码里面的换行直接用回车即可,不需要两个空格。
Here is a code block.

#include <stdio.h>
int main() {
    printf("Hello World!);
    return 0;
}

分隔线语法

我习惯使用三个短横线,即---

链接语法

语法如是 -> [超链接显示名](超链接地址 "超链接title(可选)")

example: Markdown语法

使用尖括号<>可以很方便地把URL或者email地址变成可点击的链接。

图片语法

语法如是 -> ![图片下方标题](图片链接或地址 "鼠标放在图片上的title"(可选))

本地图片我一般放在 /images/(文章标题)/xxx.jpg
链接的图片好像还没有尝试成功过

给图片加链接语法太复杂记不住,而且我几乎用不上。

转义字符语法

要显示原本用于格式化 Markdown 文档的字符,请在字符前面添加反斜杠字符 \ 。

* Without the backslash, this would be a bullet in an unordered list.

Markdown内嵌HTML标签

不懂捏,老师没教.jpg
(to be continue…)


Markdown语法教程笔记
http://example.com/2024/08/15/Markdown语法教程/
作者
郭子阳
发布于
2024年8月15日
许可协议