Markdown(3)

链接

自动链接

写一个网址,Typora会自动识别。在Typora里按Ctrl加鼠标左键点击就可以打开对应网站。导出的网页或者PDF中这些网址会被渲染为链接。鼠标左键点击就可以打开对应网站。

不过这是不太标准的写法。标准写法应该是把网站用尖括号括起来。所见即所得模式下,光标移开后尖括号会隐藏。光标重新移动到链接上时尖括号会显示。

这是一个网址<http://www.google.com>

实际上也不仅仅限于网址。URL都可以。比如邮箱地址:

我的邮箱地址是<qiwangnuc@foxmail.com>

文字链接

如果想把链接绑定到特定的文字上可以使用这种行内格式。要链接的文字用方括号括起来,后边紧跟一对圆括号,圆括号内写链接地址。

这是一个[链接](http://www.google.com)。

链接地址也可以是本地文件的路径(相对路径和绝对路径都可以),这样点击的时候就能打开路径对应的文件。

这个[链接](006_MarkDown(2).md)不一定会生效。因为你电脑上可能没有一个与之同名的文件。

如果你觉得这种写法太过冗长。可以用引用式文字链接。

首先要定义引用链接。引用由一对方括号和紧邻的冒号组成。方括号内写引用ID(实际就是一个字符串做标识符),冒号后边写链接地址。

[link12]:http://www.google.com

然后就可以在正文中使用行内引用式文字链接了。只需要把写链接的圆括号换成方括号,并且其中写上已定义的链接的ID。

这也是一个[链接][link12]。

注意,引用链接的定义一般不会被渲染出来(但是Typora的所见即所得模式会显示)。建议统一定义在文章最后或者一个固定的地方。

title属性

在HTML的链接标签中,有一个可选的title属性。如果浏览器支持,当鼠标悬停在链接上时将会显示链接的title属性。一般可以作为链接的补充说明。

在文字链接中,如果在链接地址后空一格写一个字符串(以双引号作为字符串标记),那么所写的字符串就会被解读为title属性。

这是一个[链接](http://www.google.com "真的是个链接")。这也是[一个链接][link15]。[link15]:https://www.wikipedia.org/ "维基主页"

注意所有的语法符号都是英文符号。尤其小心,不要把圆括号打成中文圆括号。

图片

Markdown可以插入图片。但是图片不会保存在Markdown文件中。你可以通过链接在Markdown中引用所要插入的图片。这样在渲染的时候会自动把图片渲染出来。如果导出成PDF,则会把图片保存到PDF文件中。

图片链接的格式和文字链接类似。不过开头加!。虽然格式类似文本链接,但是我还是建议图片链接单独占一段,当作段落标记使用。

![Markdown标志](https://www.fullstackpython.com/img/logos/markdown.png)
图1:Markdown标志

可能你会问,既然插入图片了,还要方括号里的文字干什么。这个文字叫做替代文字。当你引用的图片找不到的时候,就会用这串文字替代在本来应该图片出现的地方。

图片链接后边也可以空格写title属性。这点和文字链接类似。但是图片链接一般不能点击打开。

你可以使用本地图片。只需要把图片链接换为本地文件链接就可以。注意在写本地文件路径的时候,如果图片和Markdown文本在同一目录层级之下,可以直接写图片文件名(记得后缀名)。这算是相对路径。另外注意路径中尽量不要用一些特殊符号,以防无法解析路径。

Typora中可以设置开启自动保存图片。当你从剪贴板往Markdown中粘贴图片时,Typora会自动在本地保存图片并且在Markdown中生成引用路径。

你可以插入GIF动态图。Typora编辑器和大部分浏览器也支持浏览动态图。但是打包成PDF后,似乎只能打包成静态图片。

注脚

注脚类似于引用式的文字链接的使用方法。你需要定义一条注释,然后在需要引用注释的地方写上角标。这样,当你鼠标悬停到注脚上的时候就会显示注释中的内容。注脚的写法是方括号内加^然后写注释代号。注释则一般写成一个单独的段落。注释开头写上所对应的注脚,然后加:,然后空一格写注释内容。

一天世界君一睡觉就是一天[^1]。[^1]: 来源是关于一天世界君的传闻。

需要注意,注释的定义不同于链接定义,一般渲染后会显示出来。所以建议统一写在文末。另外注释的内容可以是普通文字叙述,不一定是链接。

注释和注脚的作用,就相当于论文中的文献引用标记。如果你希望把文章写得引述详实,有理有据,又不希望行文冗长,可以使用注脚来说明引用、出处、文献参考等。

表格

有的编辑器可能不支持Markdown表格,或者所支持的表格不是这种写法。我这里是按照GFM和Typora介绍的。

Markdown中的表格只是一个很轻量级的展示数据的方式。并不像Excel等电子表格那样有复杂的处理功能。

表格的基本语法是这样的:

  • 一整个表格是一个段落,前后最好空行。但是表内部的行之间不能空行。
  • 用LF换行来表示不同的行。
  • 而用|表示列的分割。一行的开头和结尾都要有|,但是表中任何地方不能连用两个|
  • 在一对|之间填写单元格中的内容。单元格内容和|之间至少空一格。
  • 空单元格用建议空格作为填充内容。

源码中表格的第一行和第二行有特殊作用。

  • 第一行是表头。
  • 第二行是表头和表格主体的分割线。第二行中的单元格以大于等于3个-填充
  • 第二行的单元格中可以往连续的几个-前后加:。如果加左侧表示这一列左对齐,加右侧表示右对齐,加双侧表示居中。不加表示默认对齐方式(Typora默认貌似是左对齐)。
表5: 太玄关注的Up的特点| 酒石酸 | 黑猫 | 一天世界君 | 太玄 |
| :---  | ---: | :------: | --- |
| 勤劳   | 大佬 | 咕咕咕    | 自恋 |
| 东方厨 | 萌   | 睡觉      | |
| 分析纯 | 萌   | 咕咕咕    | |
| MC    | 萌   | 睡觉      | |

强迫症可以用空格把源码对齐。但是不是特别必要。

Typora的所见即所得模式下输入表头行后按Enter就能自动渲染。填写表格的时候,按Tab移动到右边一格。按Enter移动到下边一格。按Ctrl+Enter增加一行。按Shift+Ctrl+Backspace或者Shift+Ctrl+Backspace删除光标所在行(只剩一行时不能删除)。

鼠标移动到行首位置可以拖动整行,更换表格行顺序。

另外在Typora中可以右键空白处使用表格工具插入表格。当光标在表格内的时候也会浮现表格编辑工具按钮。Typora的Mac版还支持Touch Bar。

杂项

分割线

标记---单独占一行表示一条分割线。你也可以用***单独占一行表示分割线。但是不管用那种,请统一使用一种。

唐王被困淤泥河,欲知何人前来救驾,且听下回分解。---上回书说到唐王被困淤泥河……

emoji

如果用UTF-8编码保存的话,直接把emoji表情粘贴到文本中或者直接用输入法输入表情就可以。这里介绍的是GFM风格的一种Markdown语法。你可以在书写的时候在一对:之间写上emoji表情的名字。这样在编译渲染之后就会转化为对应的表情。

在嘛?我要睡觉了:smile:

更多表情名参见GFM风格Markdown所支持的表情列表。

Unicode字符

如果要插入一些输入法不支持的Unicode字符。在Typora中可以直接按HTML中Unicode的使用方式书写。开头&#结尾;。中间Unicode编号(x表示十六进制编号。)

插入HTML风格的Unicode字符插入方式Ĩ。

HTML

Markdown中可以直接使用HTML标签。所以有什么Markdown本身不支持的语法直接用HTML标签表示就可以。

例如<u>下划线</u>。
<span style='color:red'>span标签。</span>
键盘按键显示<kbd>Ctrl</kbd>。
<ruby>上 <rp>(</rp><rt>Shang</rt><rp>)</rp>标 <rp>(</rp><rt>Biao</rt><rp>)</rp>注 <rp>(</rp><rt>Zhu</rt><rp>)</rp>释 <rp>(</rp><rt>Shi</rt><rp>)</rp>
</ruby>

整段的HTML也是可以的。并且Typora的所见即所得模式下,编辑整段HTML时HTML会以代码段那样的样式显示。编辑完后自动渲染为应该表现出来的效果。下边是一段Typora官网上的示例代码。

<details><summary>I have keys but no locks. I have space but no room. You can enter but can't leave. What am I?</summary>A keyboard.
</details>

由于有的HTML标签有交互性。在 Typora的所见即所得模式下,当你点击一段已经完成的HTML时可能打不开编辑模式。这时可以按Ctrl同时左键点击,进入HTML段落的编辑模式。

Markdown本身没有注释功能。可以用HTML的注释标签。在Typora中编辑的时候能看到注释标签。但是导出之后不会显示注释的内容。

<!--我很怀疑Markdown这类排版语言是否真的需要注释功能。难道你像我一样有什么小声哔哔的话要写进去?-->

Markdown的所有样式都能用内嵌HTML的方式实现。但是建议尽量用Markdown。不得已再用内嵌HTML。因为Markdown的写法非常简洁,容易写也容易读。

音频和视频

使用HTML标签可以插入音频和视频。实现原理类似插入图片,就是在Markdown中引用音频或视频文件。在Typora中可以直接播放引用的视频或者音频(如果找得到的话)。但是导出后不一定支持(看具体的导出格式和路径)。

<video src="C:/Users/TaiXuan/Videos/20181001-204042287.mp4"/><audio src="C:/Users/TaiXuan/Music/Jose Cancela & Amy Marie Beauchamp - An Entrance.mp3">

博客

Typora对YAML博客系统在Markdown中新增的标题头有语法支持。详见官方说明。

拓展模块

Typora还支持很多拓展语法。但是由于这些语法基本上都是独立的小语言,在这篇文章中三言两语介绍不完。这里就先简单提一下。

  • TeX风格的数学公式。

    • Typora用MathJax渲染数学公式。
    • 有的编辑器会用KaTex渲染数学公式。
  • 用标记语言描述框图。
    • Typora支持用js-sequence渲染序列图。
    • Typora支持用flowchart.js渲染流程图。
    • Typora支持用mermaid渲染序列图、流程图和甘特图。

Markdown (3)相关推荐

  1. lisp协议instand_分享|Linux 上 10 个最好的 Markdown 编辑器

    在这篇文章中,我们会点评一些可以在 Linux 上安装使用的最好的 Markdown 编辑器. 你可以在 Linux 平台上找到非常多的 的 Markdown 编辑器,但是在这里我们将尽可能地为您推荐 ...

  2. 【其他】将幕布文章OPML转换为Markdown的方法

    使用幕布可以快速地进行笔记中格式缩进和笔记管理等操作,但是,幕布只提供了Word.PDF.图片.HTML.OPML.思维导图的导出,以下是把幕布的大纲转换成Markdown的方法. 1.先把幕布里的文 ...

  3. 【注意事项】Markdown遇到的小问题

    写博客的目录的时候遇到了一个小问题 在博客三级标题里插入了一个超链接,在正文里看显示格式是正常的 但是文章开头的目录中却出现了显示异常的问题,把Markdown代码直接显示出来了 后来发现是文本里面[ ...

  4. 推荐几个微信Markdown排版工具

    Md2All Markdown Nice WeChat Format 参考链接 原文链接

  5. Markdown入门简介

    参考 http://sspai.com/25137 作者: Te_Lee 文章来源: 少数派 Markdown入门简介(使用工具Haroopad) 一.使用的工具----haroopad(http:/ ...

  6. atom搭建markdown环境

    1. 搭建markdown环境 > 禁用atom自带的markdown-preview插件(功能简单) > 安装插件:markdown-preview-plus@2.4.16(在markd ...

  7. 在Ubuntu 14.04 64bit上安装Markdown和绘图软件Haroopad

    简介 Haroopad:一款让你欲罢不能的Markdown编辑器 身为大程序员,我本来是不需要 Markdown 编辑器的,但是 Haroopad 让我简直欲罢不能,不能再爱更多.跨平台,代码高亮,V ...

  8. 在Ubuntu 14.04 64bit上安装Markdown编辑器Remarkble

    目前Markdown已经是非常流行和高效的文档整理和书写工具语言, 我以前接触过, 但是一直没有坚持下来, 这次五一假期期间我强迫自己去熟悉它的语法格式和编辑器, 原来我在Ubuntu 14.04 6 ...

  9. 【Tools】Markdown数学符号公式(史上最全公式表)

    Markdown数学符号&公式 文章目录 Markdown数学符号&公式 1. 希腊字母表 2. 希腊字母 3. 数学符号表 4. 数学符号 5. 数学符号补充表 6. 数学符号补充 ...

  10. Markdown编辑器使用

    Markdown编辑器使用 欢迎使用Markdown编辑器 新的改变 功能快捷键 合理的创建标题,有助于目录的生成 如何改变文本的样式 插入链接与图片 如何插入一段漂亮的代码片 生成一个适合你的列表 ...

最新文章

  1. ssm 异常捕获 统一处理_统一异常处理介绍及实战
  2. VMware converte报错记录
  3. mapreduce task与spark task对比
  4. NLP先验知识(一)
  5. TDDFT计算软件Octopus学习笔记(七): 二维材料计算(WS2)
  6. 干货 | 华为内部几近满分的项目管理PPT
  7. flink on yarn ——报错ResourceLocalizationService: Could not carry out resource dir checks
  8. 简历写成这样,让我成为这一届的面霸
  9. 刚刚涉足神经网络,基于TensorFlow2.0以实现鸢尾花分类为例总结神经网络代码实现的几个步骤,附代码详细讲解
  10. 陌上红尘,可有摆渡人?
  11. photoshop教程:替换颜色
  12. 家电专用降压DC-DC方案PL8310
  13. LNOI2022 退役记
  14. GIthub上关于新冠肺炎数据整理的项目汇总
  15. GAN(生成对抗网络)入门
  16. UVM virtual interface
  17. python显示3位数不够0补位_关于Python开发中的那些坑总结,令人防不胜防,建议收藏!...
  18. c#语言入门 刘老师,c#单元测试实例(学习刘老师视频)
  19. 盗窃案件办理中的问题及思路
  20. 目标检测算法——单次目标检测器

热门文章

  1. C#使用MQTTnet的websocket加密方式(wss)实现MQTTClient
  2. java10 运行“HelloWorld”错误:找不到或无法加载主类 原因: java.lang.ClassNotFoundException 的方法
  3. 小程序开发者互助联盟
  4. 【转】直播平台如何实现商业变现?
  5. java编程用户输入两个数字_编写一个Java应用程序,要求从键盘输入两个整数,计算这两个数据...,编写一个Java应用程序,要求从键盘输入一个数,判断该数是不...
  6. Java、使用循环语句打印4个图案
  7. 【★】Web精彩实战之
  8. 改变千万人生的一堂课(第三篇 个人魅力)
  9. U 盘安装 CentOS7 时盘符和安装源不可用问题
  10. 【前端44_前后端交互_跨域】前端解决:JSONP、后端解决:CORS 、后端代理