[other] 第一章 Markdown


前言

参考Markdown官方教程
Markdown是什么:Markdown 是一种轻量级的标记语言,可用于在纯文本文档中添加格式化元素。
Markdown有什么用:Markdown 是做笔记、为网站创建内容以及生成可打印文档的快速、简便的方法。
如下是Markdown教程:


一、标题

说明:#
可选:还可以在文本下方添加任意数量的 == 号来标识一级标题,或者 – 号来标识二级标题。
示例:
Heading level 1
=========
Heading level 2
---------

二、段落

说明:要创建段落,请使用空白行将一行或多行文本进行分隔。不要用空格(spaces)或制表符( tabs)缩进段落。
示例:
I really like using Markdown.

I think I’ll use it to format all of my documents from now on.

三、换行

说明:最佳实践是使用<br>标记。还有一种方式是在一行的末尾添加两个或多个空格,然后按回车键,即可创建一个换行(<br>)。
示例:
first line

second line
third line

四、强调语法

说明:

  • 使用** 粗体 加粗文本
  • 使用__ 粗体 加粗文本(部分可用)
  • 使用* 斜体 突出显示文本
  • 使用_ 斜体 突出显示文本
  • 使用*** 同时 应用粗体和斜体
  • 使用___ 同时 应用粗体和斜体

五、引用语法

说明:要创建块引用,请在段落前添加一个 > 符号。
示例:

这是引用

这是引用第三行
外层引用

嵌套块引用

带有其它元素的块引用

  • 无序列表

粗体斜体

六、列表语法

说明:

  • 可以将多个条目组织成有序或无序列表。
  • 要创建有序列表,请在每个列表项前添加数字并紧跟一个英文句点。 数字不- 必按数学顺序排列,但是列表应当以数字 1 起始。
  • 要创建无序列表,请在每个列表项前面添加破折号 (-)、星号 (*) 或加号 (+) 。缩进一个或多个列表项可创建嵌套列表。

示例:

有序列表
  1. first item
  2. second item
  3. third item
    1. third Indented item
    2. third Indented item
  4. fourth item
无序列表
  • First item
  • Second item
  • Third item
    • Indented item
    • Indented item
  • Fourth item
在列表中嵌套其他元素

要在保留列表连续性的同时在列表中添加另一种元素,请将该元素缩进四个空格或一个制表符.
从实际操作来看,要达到该效果,需要在列表和其他元素之间插入一行。

  • first line

    abcdefg

  • second line

    <html>
        <head>
          <title>Test</title>
        </head>
    </html>
    
  • third line

七、代码语法

说明:

  • 要将单词或短语表示为代码,请将其包裹在反引号 (`) 中。
  • 如果你要表示为代码的单词或短语中包含一个或多个反引号,则可以通过将单词或短语包裹在双反引号(``)中。
  • 要创建代码块,请将代码块的每一行缩进至少四个空格或一个制表符。
  • 要使用受保护的代码块,在代码块之前和之后的行上使用三个反引号(```)或三个波浪号(~~~)

示例:

  • 反引号:input <html> <head> </head> </html>.

  • 转义反引号: input Use `code` in your Markdown file.

  • 代码块:

    <html>
      <head>
      </head>
    </html>
    
  • 围栏代码块:

    {
      "firstName": "John",
      "lastName": "Smith",
      "age": 25
    }
    

八、分隔线语法

说明:
要创建分隔线,请在单独一行上使用三个或多个星号 (***)、破折号 (—) 或下划线 (___) ,并且不能包含其他内容。
示例:




九、链接语法

说明:

  • [超链接显示名] (超链接地址 “超链接title”)
  • URL或email:使用尖括号可以很方便地把URL或者email地址变成可点击的链接。
  • 带格式化的链接:粗体强调、斜体、代码。
  • 引用类型链接:
    引用样式链接是一种特殊的链接,它使URL在Markdown中更易于显示和阅读。参考样式链接分为两部分:与文本保持内联的部分以及存储在文件中其他位置的部分,以使文本易于阅读。

示例:
I love supporting the EFF.
I love supporting the EFF.
See the section on code.
[hobbit-hole] archorA

十、图片语法

说明:

  • ![图片alt](图片链接 “图片title”)
  • [![图片alt](图片链接 “图片title”)](超链接地址)
    示例:
    [![linux官网](https://www.linux.org/images/logo.png “org.linux picture”)](https://www.linux.org/)

十一、转义字符语法

说明:

  • 基本语法:要显示原本用于格式化 Markdown 文档的字符,请在字符前面添加反斜杠字符\。
  • 特殊字符自动转义:在 HTML 文件中,有两个字符需要特殊处理: < 和 & 。 < 符号用于起始标签,& 符号则用于标记 HTML 实体。Markdown 允许你直接使用这些符号,它帮你自动转义字符。

十二、内嵌HTML标签

说明:

  • 对于 Markdown 涵盖范围之外的标签,都可以直接在文件里面用 HTML 本身。
  • HTML 的行级內联标签不受限制,可以在 Markdown 的段落、列表或是标题里任意使用。
  • 区块元素,必须在前后加上空行,以便于内容区分。而且这些元素的开始与结尾标签,不可以用 tab 或是空白来缩进。
  • 在 HTML 块级标签内不能使用 Markdown 语法。
  • 出于安全原因,并非所有 Markdown 应用程序都支持在 Markdown 文档中添加 HTML。

十三、扩展语法 {#extended-syntax}

表格

说明:要添加表,请使用三个或多个连字符(—)创建每列的标题,并使用管道(|)分隔每列。您可以选择在表的任一端添加管道。
示例:

SyntaxDescription
HeaderTitle
ParagraphText
围栏代码块

说明:

  • Markdown基本语法允许您通过将行缩进四个空格或一个制表符来创建代码块。如果发现不方便,请尝试使用受保护的代码块。根据Markdown处理器或编辑器的不同,您将在代码块之前和之后的行上使用三个反引号(```)或三个波浪号(~~~)。
  • 许多Markdown处理器都支持受围栏代码块的语法突出显示。
脚注

说明:
脚注使您可以添加注释和参考,而不会使文档正文混乱。当您创建脚注时,带有脚注的上标数字会出现在您添加脚注参考的位置。读者可以单击链接以跳至页面底部的脚注内容。
示例:
Here’s a simple footnote,(1:my footnote) and here’s a longer one.2

标题编号

说明:许多Markdown处理器支持标题的自定义ID - 一些Markdown处理器会自动添加它们。添加自定义ID允许您直接链接到标题并使用CSS对其进行修改。要添加自定义标题ID,请在与标题相同的行上用大括号括起该自定义ID。
示例:
this is a link: link head.

定义列表

说明:一些Markdown处理器允许您创建术语及其对应定义的定义列表。要创建定义列表,请在第一行上键入术语。在下一行,键入一个冒号,后跟一个空格和定义。

删除线

说明:要从文档中删除。若要删除单词,请在单词前后使用两个波浪号~~。

任务列表语法

说明:任务列表使您可以创建带有复选框的项目列表。在支持任务列表的Markdown应用程序中,复选框将显示在内容旁边。要创建任务列表,请在任务列表项之前添加破折号-和方括号[ ],并在[ ]前面加上空格。要选择一个复选框,请在方括号[x]之间添加 x 。

使用 Emoji 标签

说明:有两种方法可以将表情符号添加到Markdown文件中:将表情符号复制并粘贴到Markdown格式的文本中,或者键入emoji shortcodes。

自动网址链接

说明:许多Markdown处理器会自动将URL转换为链接。

N、其他

输入空格的几种方式
  1. html实体

    &nbsp;# #
    &ensp;# #
    &emsp;# #
    &thinsp;# #
    &zwnj;#‌#
    &zwj;#‍#

  2. 内嵌行公式
    说明:$~~~~$
    示例:
    |   ~   1     ~~~     2     ~~~     3     ~~~     4   ~   |

    |   ~   5     ~~~     6     ~~~     7     ~~~     8   ~   |

    |   ~   9     ~~~     10   ~   11   ~   12   ~   |

    |   ~   13   ~   14   ~   15   ~   16   ~   |

  3. 应用样式

     <style>
       p {
         text-indent: 2em
       }
     </style> 
    

  1. This is the first footnote. ↩︎

  2. Here’s one with multiple paragraphs and code. ↩︎

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值