pexels-joyston-judah-331625-933054.jpg

Credit:Pexels;

markdown 语法常用常新,在这里稍微记录一下。

markdown 介绍

.md,markdown 文档文件后缀;Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。Typecho 默认使用的也是 markdown 编辑器,遵循 markdown 语法格式;

GitHub 如何换行

换行(英语:newline、line ending、end-of-line (EOL)、line Feed (LF)、line break),在计算机领域中是加在一行文字最后位置的特殊字符,在换行符下一个字符将会出现在下一行。实际上换行字符根据不同的硬件平台或操作系统平台会有不同的编码方式。 Credit: Wikipedia;

word 中,如需换行,直接回车即可;
正则表达式中,用 \n 匹配换行符
Markdown 编辑器中,需在行末空两格,再回车;

以下,本文示例

你今天吃饭了吗
吃了 你呢
吃了

没有成功换行.png

如上图(举例):在编写 GitHub README.md 文档时,粘贴以上三行文字,在未在行末空两格的情况下,你会得到如上结果:只有1行,且只用1个空格隔开,与预期不符;初学者一开始总会闹出这样的笑话;

正确的换行方式

GitHub 换行——在行末空两格.png

如上图:遵循 markdown 语法:在需换行的字段的末尾添加两个或多个空格,然后按回车键继续输入下一行的内容,即可创建一个换行( <br/> )。

最终预览结果如下:

GitHub 换行.png

当然,除了空两格,也可以使用 <br> 标签添加换行符:

你今天吃饭了吗<br>
吃了 你呢<br>
吃了<br>

或着

你今天吃饭了吗<br>吃了 你呢<br>吃了<br>

嗯,显得有点蠢...

参阅

基本撰写和格式语法https://docs.github.com/zh/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax
GitHub 文档:在 GitHub 旅程中随时为你提供帮助 -> https://docs.github.com/zh
markdown 教程https://www.runoob.com/markdown/md-tutorial.html

最后修改:2024 年 09 月 27 日 01 : 54 AM