Markdown 基本语法

Markdown 是一种纯文本格式的标记语言。通过 简单 的标记语法,它可以使普通文本内容具有一定的格式。

优点和缺点我就不说了... 因为这是我接触的第一个标记语言 2019年的时候反正我觉得挺好玩的
编辑文档我用的是‘Notepad++

一、标题

需要作为"标题"的文字前面加 # 来表示
注:标准语法一般在#后跟个空格再写文字
# <-有一个空格 只有二级以下包括二级标题才能在Hexo的目录中实现快速导航

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

<font size=3.5><mark> ·Test:</mark></font>

这是二级标题

这是三级标题

这是四级标题

这是五级标题
这是六级标题

二、字体

·操作 标记语言格式 中文描述
·加粗 **这是加粗的文字** 左右分别用两个*号
·斜体 *这是倾斜的文字* 左右分别用一个*号
·删除线 ~~这是加删除线的文字~~ 左右分别用两个~~号
·变小 ~这是变小的文字~ 左右分别用一个~号
·混合操作 ***~~ 混 和 ~~*** 混合喽~(有点顺序)

<font size=3.5><mark> ·Test:</mark></font>

这是加粗的文字
这是倾斜的文字
这是加删除线的文字
这是变小的文字
~~ 混 和 ~~


三、引用

在引用的文字前加>即可。引用也可以嵌套,如加两个>>三个>>>
n个...
貌似可以一直加下去,但没神马卵用

>这是引用的内容
>>这是引用的内容
>>>>>>>>>>这是引用的内容

<font size=3.5><mark> ·Test:</mark></font>

这是引用的内容

这是引用的内容

这是引用的内容


四、分割线

三个或者三个以上的 - 或者 * 都可以

---
----
***
*****

<font size=3.5><mark> ·Test:</mark></font>





显示效果是一样的(确信斜眼笑


五、图片

  • [图片上传失败...(image-f306bd-1592998382338)]
  • '图片alt'是显示在图片下面的文字(注释~
  • '图片title'是当鼠标移到图片上时显示的~
![blockchain](https://XXXXXX.jpg "Pokemon")

<font size=3.5><mark> ·Test:</mark></font>
[图片上传失败...(image-5c9eb7-1592998382338)]


六、超链接

<font size=3.5>[超链接名](超链接地址 "超链接title") #title可加可不加</font>

[简书](http://jianshu.com)
[GitHub](https://github.com/ouyangzhiping/awesome-cognitive-science)
[Paste Ubuntu](https://paste.ubuntu.com)
[码云](https://gitee.com/)

<font size=3.5><mark> ·Test:</mark></font>

Paste Ubuntu

<font size=2>注:Markdown本身语法不支持链接在新页面中打开???
那么在这里提供一个思路供在新页面中打开——用html语言的a标签代替Markdown语法。</font>

<a href="超链接地址" target="_blank">超链接名</a>

示例
<a href="https://www.chiphell.com" target="_blank">CHH</a>

七、列表

  • 列表格式| 语法 | 注意
    :---------|:--------------------:|:---------------:
    ·无序列表| - + * <font size=2>任何一种都可以</font> |<font size=2>- + * 跟内容之间要空格</font>
    ·有序列表|<font size=2>数字加点</font> |<font size=2>序号跟内容之间要有空格</font>
    ·列表嵌套|<font size=2>上一级和下一级之间敲三个空格</font>|<font size=2>一二级之间一个空格即可,二三级
    之间就要3个空格了,或一个tab</font>
无序列表

- 列表内容(-)
+ 列表内容(+)
* 列表内容(*)


有序列表

1. 列表内容1
2. 列表内容2
3. 列表内容3


列表嵌套

+ 一级无序列表内容
 + 二级无序列表内容

+ 一级无序列表内容
 + 二级无序列表内容
    + 三级无序列表内容

省略有序列表嵌套    

<font size=3.5><mark> ·Test:</mark></font>

无序列表

  • 列表内容(-)
  • 列表内容(+)
  • 列表内容(*)

有序列表...突然想起来有序列表的样式被我在css里面给删掉了😅

  1. 列表内容1
  2. 列表内容2
  3. 列表内容3

列表嵌套

  • 一级无序列表内容
    • 二级无序列表内容

————————————

  • 一级无序列表内容
  • 二级无序列表内容
    • 三级无序列表内容

省略有序列表嵌套


八、表格

表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容

第二行分割表头和内容。
- 有一个就行,为了对齐,多加了几个
文字默认居左
-两边加:表示文字居中
-右边加:表示文字居右
注:原生的语法两边都要用 | 包起来。此处省略

<font size=3.5><mark> ·Test:</mark></font>

表头 表头 表头
内容 内容 内容
内容 内容 内容

九、代码块

<font size=3.5><mark> ·Test:</mark></font>

! 在行开头使用一个 Tab 可以获得一个无行标代码块的效果 注意:要与上一行之间有换行符

无行标代码块的效果

单行代码:代码之间分别用一个反引号包起来 `代码内容`

代码内容


代码块:代码之间分别用三个反引号包起来,且两边的反引号单独占一行
|```|
  代码...
  代码...     反引号旁边的'|',使用时去掉
  代码...     此处为为了防止转译
|```|

十、流程图

<font size=3.5>(这是一个神奇的东西,可是我现在还不会哈哈哈哈)</font>

安装hexo-filter-flowchart
npm install --save hexo-filter-flowchart

#使用了 . 来替换 ` 显示源码
...flow 
st=>start: Start|past:>http://www.baidu.com[blank]
e=>end: End:>http://www.google.com
op1=>operation: My Operation|past
op2=>operation: Stuff|current
sub1=>subroutine: My Subroutine|invalid
cond=>condition: Yes or No?|approved:>http://www.google.com
c2=>condition: Good idea|rejected
io=>inputoutput: catch something...|request

st->op1(right)->cond
cond(yes, right)->c2
cond(no)->sub1(left)->op1
c2(yes)->io->e
c2(no)->op2->e
...

<font size=3.5><mark> ·Test:</mark></font>

st=>start: Start|past:>http://www.baidu.com[blank]
e=>end: End:>http://www.google.com
op1=>operation: My Operation|past
op2=>operation: Stuff|current
sub1=>subroutine: My Subroutine|invalid
cond=>condition: Yes or No?|approved:>http://www.google.com
c2=>condition: Good idea|rejected
io=>inputoutput: catch something...|request

st->op1(right)->cond
cond(yes, right)->c2
cond(no)->sub1(left)->op1
c2(yes)->io->e
c2(no)->op2->e


<font size=5>hexo-renderer-markdown-it 插件 详解</font>


<center>Markdown和HTNL混用 🎬</center>

一、文章摘要/导读

  • HTML 注释不会被渲染到页面中。
  • More 左右各留一个英文空格。
<!-- More -->

<font size=3.5><mark> ·No Test:</mark></font>
φ(* ̄0 ̄)


二、插入和删除

  • 插入和删除在审稿的时候经常用到,表示一个修改动作
  • 从标记为插入或删除的文本上,方便用户了解之前和现在的版本。
  • <del> 表示删除,<ins> 表示插入。
  • <del> 和 <ins> 一起用表示修改。
苍蝇座的位置极易分辨,它位于南十字座和 <del>长蛇座</del> <ins>半人马座</ins> 南边,蝘蜓座以北的船底座和圆规座之间的银河中,「煤袋星云」就在苍蝇座、南十字座和半人马座的交界处,在位于 +10° 到 -90° 之间纬度的地区可全见。

<font size=3.5><mark> ·Test:</mark></font>

苍蝇座的位置极易分辨,它位于南十字座和 <del>长蛇座</del> <ins>半人马座</ins> 南边,蝘蜓座以北的船底座和圆规座之间的银河中,「煤袋星云」就在苍蝇座、南十字座和半人马座的交界处,在位于 +10° 到 -90° 之间纬度的地区可全见。


三、脚注

  1. HTML 没实现出来实现
    • 关键词左边和 右边,各留一个英文空格。
    • 页底的脚注信息,用 Markdown 的有序列表语法即可。
    • 这个方法的缺点是需要人肉维护脚注的序号,应尽量少用。

Here is a footnote reference, 1 and another. 2 ,xxx实现下标

注释

  1. Here is the footnote.
  2. Here's one with multiple blocks.

实现两个链接之间互转
<a href="#bib1" id="bib1ref">[1]</a>
<a id="bib1" href="#bib1ref">[1]</a>



<font size=3.5><mark> ·No Test:</mark></font>
φ(* ̄0 ̄)

---

2. [`markdown-it-footnote 实现`](https://www.npmjs.com/package/markdown-it-footnote)
    - 脚注标识符中不能包含空格、tab或换行符,且标识符不被渲染
    - 每条脚注的前后都应该有空行
    - 如果需要在脚注中分段,可以<mark>将后面的段缩进来</mark>表示它们属于同一段脚注
    - 脚注不一定必须位于文档的最后部分,除了块元素内部
    - 脚注按照`[^1]、[^2]、...、[^longnote]` longnote是干嘛的不懂
```markdown
Here is a footnote reference,[^1] and another.[^longnote]

[^1]: Here is the footnote.
[^longnote]: Here's one with multiple blocks.
    123456789

<font size=3.5><mark> ·Test:</mark></font>

  • Here is a footnote reference,[1] and another.[2]

四、文本高亮

  • <mark> ‌是 HTML5 的新标签。
…… <mark>这是纯黄</mark> ……

<font size=3.5><mark> ·Test:</mark></font>

<mark>这是纯黄</mark>


五、文本<font>

  • 尽管 <font> 是 HTML5 的不建议标签,但语义上仍然是所有标签中最好的。
<font size="3" color="red">This is some text!</font>
<font size="2" color="blue">This is some text!</font>
<font face="verdana" color="green">This is some text!</font>
属性 描述
color <font size=2>rgb(x,x,x)
#xxxxxx
colorname</font>
<font size=2 color=red>不赞成使用。请使用样式取代它。</font>
规定文本的颜色
face font_family
<font size=2 color=red>不赞成使用。请使用样式取代它。</font>
规定文本的字体。
size number
<font size=2 color=red>不赞成使用。请使用样式取代它。</font>
规定文本的大小[3]

<font size=3.5><mark> ·No Test:</mark></font>
φ(* ̄0 ̄)


六、文字注音

  • <ruby> 和 ‌<rt> 是 HTML5 的新标签。
  • 对于一些多音字或者生癖字,留下注音能帮助读者更好的阅读。
<ruby>饕餮 <rt>tāo tiè</rt></ruby> 是古代中国神话传说中的一种神秘怪物,别名叫 <ruby>狍鸮 <rt>páo xiāo</rt></ruby>,古书《山海经·北次二经》介绍其特点是:其形状如羊身人面,眼在腋下,虎齿人手。

<font size=3.5><mark> ·Test:</mark></font>

<ruby>饕餮 <rt>tāo tiè</rt></ruby> 是古代中国神话传说中的一种神秘怪物,别名叫 <ruby>狍鸮 <rt>páo xiāo</rt></ruby>,古书《山海经·北次二经》介绍其特点是:其形状如羊身人面,眼在腋下,虎齿人手。


七、分栏

  • 分栏可以有效改善阅读体验,CSS3 里提供了分栏的样式。
  • columns 是个复合复性,参见这个介绍
  • 如果你的文章是发往多个渠道的,不建议使用。比如hexo显示的就不太好
  • 你会发现加了<font>标签来引导hexo对于html标签的渲染
><font><div style="columns: 2;">
严格地说,这个集子很难说是“自选集”。“自选集”应该是从大量的作品里选出自己认为比较满意的。我不能做到这一点。一则是我的作品数量本来就少,挑得严了,就更会所剩无几;二则,我对自己得作品无偏爱。有以为外国的汉学家发给我一张调查表,其中一栏是:“你认为自己最具有代表性的作品是哪几篇”,我实在不知道如何填。我的自选集不是选出了多少篇,而是从我的作品里剔除了一些篇。这不像农民田间选种,倒有点像老太太择(zhai)菜。老太太择菜是很宽容的,往往把择掉的黄叶、桔梗拿起来再看看,觉得凑活着还能吃,于是又搁回到好菜的一堆里。常言说:剪刀篮里的都是菜,我对自选集就有一点是这样。
<br><br>汪曾祺先生 一九八六年十二月十四日序于北京蒲黄榆路寓居~
</div></font>

<font size=3.5><mark> ·Test:</mark></font>

<font size=3 face="楷体"><div style="columns: 2;">
严格地说,这个集子很难说是“自选集”。“自选集”应该是从大量的作品里选出自己认为比较满意的。我不能做到这一点。一则是我的作品数量本来就少,挑得严了,就更会所剩无几;二则,我对自己得作品无偏爱。有以为外国的汉学家发给我一张调查表,其中一栏是:“你认为自己最具有代表性的作品是哪几篇”,我实在不知道如何填。我的自选集不是选出了多少篇,而是从我的作品里剔除了一些篇。这不像农民田间选种,倒有点像老太太<ruby>择<rt>zhai</rt></ruby>菜。老太太择菜是很宽容的,往往把择掉的黄叶、桔梗拿起来再看看,觉得凑活着还能吃,于是又搁回到好菜的一堆里。常言说:剪刀篮里的都是菜,我对自选集就有一点是这样。



汪曾祺先生 一九八六年十二月十四日序于北京蒲黄榆路寓居~
</div></font>


八、数学公式

  • 在两边再包围一对$,可以嵌入一个数学公式块。
 $\sum_{i=1}^n a_i=0$

呕吼 好像现在还不支持


九、折叠代码块

  • <details>标签前面需要有空格等占位符(hexo好像不用)
  • <summary> 标签中为标题,默认为"详细信息"
  • 代码块内可以用markdown
这是一个折叠代码块
 <details>
<summary>点击查看折叠代码块</summary>

</details>

<font size=3.5><mark> ·Test:</mark></font>

这是一个折叠代码块
<details>
<summary>点击查看折叠代码块</summary>
<font size=3 face="楷体"><div style="columns: 2;">
严格地说,这个集子很难说是“自选集”。“自选集”应该是从大量的作品里选出自己认为比较满意的。我不能做到这一点。一则是我的作品数量本来就少,挑得严了,就更会所剩无几;二则,我对自己得作品无偏爱。有以为外国的汉学家发给我一张调查表,其中一栏是:“你认为自己最具有代表性的作品是哪几篇”,我实在不知道如何填。我的自选集不是选出了多少篇,而是从我的作品里剔除了一些篇。这不像农民田间选种,倒有点像老太太<ruby>择<rt>zhai</rt></ruby>菜。老太太择菜是很宽容的,往往把择掉的黄叶、桔梗拿起来再看看,觉得凑活着还能吃,于是又搁回到好菜的一堆里。常言说:剪刀篮里的都是菜,我对自选集就有一点是这样。


汪曾祺先生 一九八六年十二月十四日序于北京蒲黄榆路寓居~
</div></font>
</details>


GitHub上基本的编写和格式化语法





<font size=6 face="Times New Roman"><center>Over</center></font>


  1. 示例:Here is the footnote.

  2. 示例:Here's one with multiple blocks.

    换行demo123456789

  3. Size:规定文本的尺寸大小。可能的值:从 1 到 7 的数字。浏览器默认值是 3

©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • 这是我的第一篇学习记录,先从学习markdown语法开始吧 一. 标题 语法 : 效果如下 : 一级标题 二级标题...
    NaturalCode阅读 2,738评论 2 2
  • markdown是一种纯文本格式的标记语言。通过简单的标记语法,它可以使普通文本内容具有一定的格式。 相比WYSI...
    像计算机一样思考阅读 3,153评论 0 0
  • 文章内容 markdown是一种纯文本格式的标记语言。通过简单的标记语法,它可以使普通文本内容具有一定的格式。 相...
    拒绝奢望的leaf阅读 1,787评论 0 0
  • Markdown是一种纯文本格式的标记语言。通过简单的标记语法,它可以使普通文本内容具有一定的格式。 相比WYSI...
    走在路上的低级弟弟阅读 984评论 0 1
  • Markdown是一种纯文本格式的标记语言。通过简单的标记语法,它可以使普通文本内容具有一定的格式。 相比WYSI...
    杂货铺学徒阅读 1,735评论 0 0