一小时学会Markdown

Markdown 无处不在。StackOverflow、CSDN、简书、GitBook、有道云笔记等。主流的代码托管平台,如 GitHub、Gitee 等等,都支持 Markdown 语法,很多开源项目的 README、开发文档、帮助文档、Wiki 等都用 Markdown 写作。

Markdown 是纯文本可移植的。几乎可以使用任何应用程序打开包含 Markdown 格式的文本文件。与 Microsoft Word 等文字处理应用程序形成了鲜明的对比,Microsoft Word 将你的内容锁定在专有文件格式中。

Markdown 是独立于平台的。你可以在运行任何操作系统的任何设备上创建Markdown 格式的文本。

Markdown 能适应未来的变化。即使你正在使用的应用程序将来会在某个时候不能使用了,你仍然可以使用文本编辑器读取 Markdown 格式的文本。

写Hexo Blog也得学会Markdown, 它有大用但并不难学,一个小时就足够了。

Markdown 基本语法

  • 标题: #、##、### 分别表示1~3级标题, 最多可以是6级
  • 强制换行: <br> 标签
  • 粗体: 前后各添加2个星号下划线, ** 内容 **
  • 斜体: 前后添加1个星号或下划线, * 内容 *
  • 粗体和斜体:前后添加3个星号或下划线,*** 内容 ***
  • 删除线:删除单词,请在单词前后使用两个波浪号~~
  • 引用:段落前添加一个 > 符号
  • 表格:用三个或多个连字符(—)创建每列的标题,并使用管道(|)分隔每列。您可以选择在表的任一端添加管道
  • 围栏式代码块: 用三个代码块之前和之后的行上使用三个反引号(```)或三个波浪号(~~~),这样引用的代码就当成一段普通文字,而不是当成代码了。
  • 转义字符语法:原本用于格式化 Markdown 文档的字符,比如\、*、’、_、{}、[],这些字符前面添加反斜杠字符 \之后,就只会当成*{}[]等本身的符号来处理,不作格式用了。

插入图片

方法1: 插入图片Markdown语法代码: ![图片alt](图片链接 "图片title")
方法2: 直接插入HTML代码: <img src="image.png" width="100%" height="100%" title="text" alt="alternative text."/> //文件名,比例,替代名
方法3:文字环绕图片:

<p style="width:400px;">
<img src="images/images.jpg" align="right" width="120" hspace="5" vspace="5"> </p> //hspace, vspace分别控制垂直/水平方向与文字的距离;

使用图床

在Cloudflare R2中设置存储空间,并用作图床,免费用户上限10GB/月。使用图床后在当地可能不显示图片。 问题的原是部分网站禁止外链图片,具体分析在这里 。解决方法是在主题文件夹内的 themes\fluid\layout\layout.ejs中增加语句:
<meta name="referrer" content="no-referrer"/>
然后重新生成: Hexo g

给图片增加链接解决方法

[![图片](/img/image.jpg "name")](https://link.com)

插入链接

方法1: [显示名](https://link.com/ "备注")
方法2: <a href="超链接地址" title="title">超链接显示名</a>

文字颜色、大小、位置、字体与背景色的设置

可以用HTML标记语言的方法设定文字的各种属性, 各种效果可以自由组合:

  • 文字颜色: 例如浅红色文字:<font color="#dd0000">浅红色文字</font><br />
    效果:浅红色文字

  • 背景色: <table><tr><td bgcolor=#54FF9F>背景色的设置是按照十六进制颜色值:#54FF9F</td></tr></table>

效果:

背景色的设置是按照十六进制颜色值:#54FF9F

更多十六进制颜色代码在这里

  • 文字大小: <font size="5">size为5</font><br />
    效果:

    size为 5

  • 对齐方式: <p align="right">右对齐</p> // right, center, left
    效果:

    文字居中对齐

  • 字体设置: <font face="黑体">我是黑体字</font> | <font face="宋体">我是宋体字</font>
    效果:

    我是黑体字 | 我是宋体字

参考网站

  1. 内容改编、摘抄自 Markdown官网文档 :指令

一小时学会Markdown
http://blog.ezdata.top/2024/08/09/3.markdown/
Author
average Joe
Posted on
August 8, 2024
Licensed under