Markdown简要教程

Jun 27th, 2020
  • 在其它设备中阅读本文章

写这个主要还是为了初一的小朋友们看了能赶紧踏上自建博客的 不归 路, 如果要想免费地自己搭一个自己的博客看 这篇教程 .

编辑器

这里推荐 Typora, 当然 VSCode+ 插件或者 Sublime 都是可以的. 不过 Typora 比较好看, 而且有很多快捷插入的功能, 就算不会 Markdown 也能写出好看的文章,官网链接 .

在编辑器顶端是菜单栏, 左下角分别是显示/隐藏侧边栏和启用/退出源代码模式两个按钮, 右下角是字数统计. 这里我们要注意的是菜单栏里的段落和格式两个选项卡.

这是段落

这是格式

基本语法

注意这里面除了给出了代码以外还给出了 "一键插入" 之类的方法. 顺序是按我自己心中的重要度来定的.

标题

因为如果打出来会影响目录所以就直接截图了.

如果要快速插入的话, 找到段落->1/2/.../6级标题, 点击即可. 还可以升高或者降低标题级别, 按钮也在那一块.Markdown 代码是 

# H1
## H2
### H3
#### H4
##### H5
###### H6

即几级标题前面有几个#, 级别越高就越小, 最多支持 $6$ 级标题.

代码

毕竟写题解什么的都离不开放代码对吧.

这是行内代码, 前后都可以写普通文本.

这是代码块
/*这是c++高亮的代码块,这一行可以过数据加强之前的A+B problem*/
main(){puts(getchar()-51?"11":"7");}

代码块的快速插入在段落->代码块, 但是行内代码好像没有快速插入. 代码 

`这是行内代码`,前后都可以写普通文本.

​```
这是代码块
​```

​```cpp
/*这是c++高亮的代码块,这一行可以过数据加强之前的A+B problem*/
main(){puts(getchar()-51?"11":"7");}
​```

看起来有点复杂了, 分析一下:

  • 行内代码用一对 "`" 包围, 在键盘左上角,"Esc" 下面;
  • 代码块一般用一对 "`"包围, 注意它们应该分别单独占据一行;
  • 如果要针对某种语言高亮, 在开头的"`"后面加上对应的语言简称即可,C++ 是"cpp",C 是"c", 伪代码是"pseudocode", 但是伪代码有很多地方不支持.

注意 ** 一般情况下代码块用一对""包围**,但是也可以用四个"`"包围, 适用于代码里本来就有该符号的情况.

选择语言也有快捷方式, 点进要选择语言的代码块, 左下角自动出现" 选择语言 "的框框

并且还有自动补全.

加粗和斜体

不要用标题强调 , 不然你的目录会乱得不成样子.

这是加粗 ,_这是斜体_, 这是加粗的斜体 (斜着的加粗).

快速插入在格式->加粗/斜体, 代码 

**这是加粗**
_这是斜体_
**_这是加粗的斜体(斜着的加粗)_**

但是斜体也可以这样写 

*这也是斜体*

不过为了和加粗分开建议用一对 "_" 包围. 另外加粗的斜体对于哪对符号在外面并没有什么特别的要求, 看个人习惯 

_**这也是加粗的斜体**_
***这还是加粗的斜体,但是不建议这么写***

删除线

这是被删掉的文本

快速插入在格式->删除线, 代码 

~~这是被删掉的文本~~

公式

$x_{1,2}=\frac{-b\pm\sqrt{b^2-4ac}}{2a}\\ 这是行内公式 $, 前后都可以写普通文本.

$$ x_{1,2}=\frac{-b\pm\sqrt{b^2-4ac}}{2a}\\ 这是公式块 $$

很有用, 但是要先会了 $\LaTeX$ 才能填出来里面的内容... 不过最下面有写代替方法, 就先讲一下格式.

公式块的快速插入在段落->公式块, 行内公式在格式->内联公式. 代码 

$x_{1,2}=\frac{-b\pm\sqrt{b^2-4ac}}{2a}\\这是行内公式$,前后都可以写普通文本.

$$
x_{1,2}=\frac{-b\pm\sqrt{b^2-4ac}}{2a}\\
这是公式块
$$

行内公式用一对 "$" 包围, 公式块在第一行前和最后一行后有 "​$$".

链接

这是一个链接

这是一个链接

快速插入在格式->超链接, 代码 

[这是一个链接](http://39.107.58.77/)

[这是一个链接](这里写链接地址)

图片

这里写如果图片挂掉会显示的内容

这里写如果图片挂掉会显示的内容

快速插入在格式->图像->插入本地图片..., 代码 

![这里写如果图片挂掉会显示的内容](http://39.107.58.77/usr/uploads/2020/06/3273811799.png)

![这里写如果图片挂掉会显示的内容](这里写图片地址)

和链接很像, 只是前面多了一个 "!"

引用

这是引用

譬如我要引 CZC 的一句话, 就可以做出来这种效果

但是本着用啥现查的原则。
在这里我们只讲解一些基本的技巧，
引自 如何写好一篇题解（and 编辑器使用方法） CZC 的标点看起来就离谱, 不要学

快速插入在段落->引用, 代码 

> 这是引用

>  但是本着用啥现查的原则。
>  在这里我们只讲解一些基本的技巧，

但是注意, 这样也是可以成功渲染的 

>  但是本着用啥现查的原则。
在这里我们只讲解一些基本的技巧，

不过出于规范的目的,很不建议 这么做.

列表

分无序列表和有序列表.

  • 这

  • 是

    • 无
    • 序
  • 列
  • 表
  1. 这

  2. 是

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

快速插入在段落->无序列表/有序列表, 如果要增加和减少缩进在稍微靠下一点的段落->列表缩进->增加缩进/减少缩进, 代码 

- 这
- 是
   - 无
   - 序
- 列
- 表

1. 这
2. 是
   1. 有
   2. 序
3. 列
4. 表

看出无序列表在行首加- 和一个空格, 有序列表在行首加数字,.和一个空格. 如果列表里面有二级列表就再在前面加 $2-4$ 个空格, 应该没什么大影响, 看个人习惯. 另外有序列表还可以这么写, 效果是一样的 

1. 这
1. 是
   1. 有
   2. 序
100. 列
1. 表

而这么写 

2. 这
1. 是
   10. 有
   2. 序
100. 列
1. 表

效果是

  1. 这

  2. 是

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

也就是说 在某些情况下 (会随着渲染器的不同而变化), 数字其实只与开头那一个有关, 所以建议全部都写成 $1$. 另外其实还有一个任务列表, 不过没什么用就不说了, 有兴趣可以自己去试.

表格

猜不到会在什么地方用到... 那就随便讲一下吧.

这 这一行叫表头
剩下的叫单元格 是这一列居中
这一列右对齐 这一列左对齐 表
格

快速插入在段落->表格->插入表格, 会出现这么一个框让你选大小

当然之后也可以在这个地方

或者这个地方

改格式和对齐方式, 加入 / 删除行 / 列等. 代码

| 这 | 这一行叫表头 | | |
| -: | :- | :-: | - |
| 剩下的叫单元格 | 是 | 这一列居中 | |
| 这一列右对齐 | 这一列左对齐 | 表 | |
| | | | 格 |

大致总结一下

  • 第一行是表头;

  • 第二行确定了很多格式, 当然无论如何至少该有一个-, 默认左对齐,

    • 左对齐是:-,
    • 右对齐是-:,
    • 居中是:-:;
  • 剩下的部分是单元格
  • 列之间用|("Enter" 上方)分隔.

脚注

这样 1 写一个脚注.

快速插入在段落->脚注, 代码 

这样[^1]写一个脚注

[^1]: 这里是脚注

如何写一篇好文章

不要滥用标题

不要全文使用标题，或者用标题强调特别多的文字。这会让读者觉得困扰。

引自 洛谷 Markdown 格式手册

该用公式的地方用公式

$$ x_{1,2}=\frac{-b\pm\sqrt{b^2-4ac}}{2a} $$

和 x1,2=(- b 加减根号 (b^2-4ac))/2a, 哪个好看不用说了吧. 实在打不来底下有教程, 再不行用图都好一些.

言辞清晰

这个... 没什么好说的, 问语文老师去.

语言描述不清楚的地方放图

也没什么好解释的.

注意事项

还有高亮(==高亮==), 上下标 (^上标^,~下标~)之类的语法, 但是不一定支持, 不建议使用.

如果传到 study 上挂了, 很大可能是 study 自己的锅.

如果不会 $\LaTeX$, 可以试一下黄老师推荐的 这个网站 , 里面有图片 / 手写识别功能.

这个教程还有不完善的地方, 记得留言指出.

可以参考 洛谷 Markdown 格式手册 .

Reference

  1. 这里是脚注 ↩

owo

蛤mo-ha
Powered by Typecho
Theme Katerial