Markdown 代码块与语法规则(转载)

Markdown 代码块与语法高亮

语法说明：

插入程序代码的方式有两种：使用反引号 `（~ 键）、使用缩进（Tab）。

• 插入行内代码，即插入一个单词或者一句代码的情况，使用 code 这样的形式插入。
• 插入多行代码，分别使用三个反引号（```）包裹多行代码。或者使用缩进。

行内代码

在一般的段落文字中，可以使用反引号 ` 来标记或插入代码区段。

C语言里的函数 `scanf()` 怎么使用？

C语言里的函数 scanf() 怎么使用？

当然也可以标记 文件名 、关键词 等。

多行代码

• 在需要高亮的代码块的前一行及后一行使用三个反引号 ```（~ 键）
• 同时第一行反引号后面，输入代码块所使用的语言，实现代码高亮。

比如高亮 python3 代码块：

    ```python
    #!/usr/bin/env python3
    print("Hello, World!");
    ```

显示为：

#!/usr/bin/env python3
print("Hello, World!");

缩进式插入多行代码

注意：
缩进式插入前方必须有空行；
缩进 4 个空格或是 1 个制表符；
一个代码区块会一直持续到没有缩进的那一行（或是文件结尾）。

代码：

此处有空行
    #include  <stdio.h>`
    int main(void)`
    {
        printf("Hello world\n");
    }

显示效果：

#include  <stdio.h>`
int main(void)`
{
    printf("Hello world\n");
}

代码区块中的内容

代码区块中，一般的 Markdown 语法不会被转换，像是 * 便只是星号，这表示你可以很容易地以 Markdown 语法撰写 Markdown 语法相关的文件。

```markdown
Markdown 语法展示
```

比如下面展示 Markdown 常用语法：

Markdown 目录：
[TOC]

Markdown 标题：
# 这是 H1
## 这是 H2
### 这是 H3

Markdown 列表：
- 列表项目
1. 列表项目

*斜体*或_斜体_
**粗体**
***加粗斜体***
~~删除线~~

Markdown 插入链接：
[链接文字](链接网址 "标题")

Markdown 插入图片：
![alt text](/path/to/img.jpg "Title")

Markdown 插入代码块：
    ```python
    #!/usr/bin/python3
    print("Hello, World!");
    ```

Markdown 引用：
> 引用内容

Markdown 分割线：
---

Markdown 换行：
<br>

Markdown 段首缩进：
&ensp; or &#8194; 表示一个半角的空格
&emsp; or &#8195;  表示一个全角的空格
&emsp;&emsp; 两个全角的空格（用的比较多）
&nbsp; or &#160; 不断行的空白格

---

访问简书专题：【集锦】Markdown 语法快速上手，10 分钟带你学会 Markdown。也可以访问 我的笔记，查看更多内容。

光懂语法还不能写出排版优秀的文章，我们还需要学习 Markdown 编写规范，让我们的文章看起来很专业。已经有好人写了文章：

• Markdown 编写规范
• 技术文档写作规范（Markdown）

少数派 的文章排版比较规范，大家可以多逛逛。

学会了排版，要写出一篇优秀的文章，我们还要在内容管理上下功夫，最基本的素养就是不要传递错误的信息，其次是关注所传递内容的价值大小。这时候，我们不仅要有相关专业知识（有理有据），还要想文章的框架结构，要考虑读者的感受等。平时看热门文章和畅销图书时，多留意它们的排版和文章结构，都可以学习借用。这里只是抛砖引玉，详细技巧可以知乎一下。

参考文章

• Markdown 语法手册 （完整整理版）

非常感谢原博主，原文章链接：https://www.jianshu.com/p/65ab196bef04

__EOF__

本文作者：damarkday知识库
本文链接：https://www.cnblogs.com/GoodMemoryBlog/articles/14194239.html
关于博主：评论和私信会在第一时间回复。或者直接私信我。
版权声明：本博客所有文章除特别声明外，均采用 BY-NC-SA 许可协议。转载请注明出处！
声援博主：如果您觉得文章对您有帮助，可以点击文章右下角【推荐】一下。您的鼓励是博主的最大动力！