Markdown 基本语法整理


=Start=

缘由:

简单记录一下我在写 Markdown 文件时常用的语法,方便有需要的时候参考。

正文:

参考解答:

Markdown是一种轻量级标记语言,排版语法简洁,让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档,可与HTML混编,可导出 HTML、PDF 以及本身的 .md 格式的文件。因简洁、高效、易读、易写,Markdown被大量使用,如Github、Wikipedia、简书等。

  • Markdown 列表/嵌套列表
  • Markdown 链接
  • Markdown 表格
  • Markdown 分隔线
  • Markdown 代码/代码块
  • Markdown 引用
  • Markdown 字体颜色大小设置

Markdown 列表

Markdown 支持有序列表和无序列表。

无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记,这些标记后面要添加一个空格,然后再填写内容:

* 第一项
* 第二项
* 第三项

有序列表使用数字并加上 . 号来表示,如:

1. 第一项
2. 第二项
3. 第三项

列表嵌套只需在子列表中的选项前面添加两个或四个空格(最好是4个空格)即可:

1. 第一项:
    - 第一项嵌套的第一个元素
    - 第一项嵌套的第二个元素
2. 第二项:
    - 第二项嵌套的第一个元素
    - 第二项嵌套的第二个元素

Markdown 链接

链接使用方法如下:

[链接名称](链接地址)

或者

<链接地址>

Markdown 表格

Markdown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行。

语法格式如下:

|  表头   | 表头  |
|  ----  | ----  |
| 单元格  | 单元格 |
| 单元格  | 单元格 |

设置表格的对齐方式:

| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

Markdown 分隔线

要创建分隔线,请在单独一行上使用三个或多个星号 (***)、破折号 (---) 或下划线 (___) ,并且不能包含其他内容。以上三个分隔线的渲染效果看起来都一样。

说明:为了兼容性,请在分隔线的前后均添加空白行

Try to put a blank line before...

---

...and after a horizontal rule.

Markdown 代码/代码块

如果是段落上的一个函数或片段的代码可以用反引号把它包起来(`),例如:

printf() 函数

代码区块使用 “` 包裹一段代码,并指定一种语言(也可以不指定):

$(document).ready(function () {
    alert('RUNOOB');
});

Markdown 引用

Markdown 区块引用是在段落开头使用 > 符号 ,然后后面紧跟一个空格符号:

> 区块引用
> 菜鸟教程
> 学的不仅是技术更是梦想

区块引用
菜鸟教程
学的不仅是技术更是梦想

另外区块是可以嵌套的,一个 > 符号是最外层,两个 > 符号是第一层嵌套,以此类推:

> 最外层
> > 第一层嵌套
> > > 第二层嵌套

显示效果如下:

最外层

第一层嵌套

第二层嵌套

Markdown 字体颜色大小设置

Markdown 本身不支持修改字体、字号与颜色等,还好 Markdown 支持 HTML 语言,所以我们采用 HTML 语法格式即可。

设置字体、字号和颜色的代码如下(借助 font 标签中的 color/size/face 等属性):

<font face="黑体"> 我是黑体字 </font>
<font face="微软雅黑"> 我是微软雅黑 </font>

<font color=gray size=7> color=gray </font>
<font color=#00ffff size=7> color=#00ffff </font>
<font color=#0099ff size=7 face="黑体"> color=#0099ff size=7 face="黑体" </font>

// Size:规定文本的尺寸大小。可能的值:从 1 到 7 的数字。浏览器默认值是 3。
font 是一对常规标签,font 标签内设置 color="对应颜色值" 即可设置对象内字体的颜色:

<font color="red"> 我是红色字体 </font> 或者 <font color="#FF0000"> 我也是红色字体 </font> 
参考链接:

Markdown 语法・简明版
https://keatonlao.gitee.io/a-study-note-for-markdown/syntax/

如何在 Markdown 中修改字体颜色
https://stackoverflow.com/questions/35465557/how-to-apply-color-on-text-in-markdown
https://blog.vvzero.com/2022/05/06/How-to-apply-color-in-Markdown/

=END=

,

《 “Markdown 基本语法整理” 》 有 3 条评论

  1. QuickLook Markdown preview and icon thumbnailing app extensions for macOS Catalina and beyond
    为macOS Catalina和更高版本系统开发的 QuickLook Markdown 预览和图标缩略图应用程序扩展
    https://github.com/smittytone/PreviewMarkdown
    `
    这个应用程序为Catalina和更高版本的macOS提供了Markdown文件预览和缩略扩展。
    `

    How to create file previews in macOS
    如何在macOS中创建文件预览
    https://blog.smittytone.net/2019/11/07/create_previews_macos_catalina/
    `
    macOS Catalina引入了一种新的机制来提供文件预览和基于内容的文件图标。做这个的系统仍然是 QuickLook ,但是独立的或应用程序托管的 QuickLook 生成器已经使用了一段时间了,已经被弃用了,取而代之的是**通过应用程序扩展提供这个功能**。
    `

  2. 好用的网页内容转Markdown工具
    https://zhuanlan.zhihu.com/p/671636492
    `
    因为平时记录的笔记在不同的平台发布,后面需要保存成mrakdown的格式又找不到本地的文件记录,本地存储的好处很多,比如可以离线浏览阅读,对网页进行备份,也能借助其他工具同步数据而来满足自己的工作流程。这是这些工具将会简化你的操作:

    一、在线工具推荐
    1. devtool
    2. helloworld

    二、Google插件
    1. MaoXian Web Clipper
    2. Copy as Markdown
    3. 网页转成markdown
    `
    https://devtool.tech/html-md
    https://www.helloworld.net/html2md

  3. 有什么好办法,将网页内容保存为 markdown
    https://www.v2ex.com/t/949166
    `
    markdown 处理图片,要么外链,要么附件,都不太好。我喜欢把网页打印成 pdf 文件,文字可复制,排版也一致

    试试 Chrome 插件 singlefile 可以把图片,保存到一个 html 文件里面

    试试 Typora ,全选网页内容复制,然后粘贴到 Typora 创建的 md 文件里面,会自动转换,图片也会创建对应目录保存

    chrome 插件 MarkDownload – Markdown Web Clipper

    MarkDowload ,可以一键发送 md 到 obsidian ,解决了剪藏到 ob 的痛点。
    `

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注