标签 Markdown 下的文章

每个人都有自己喜欢的 Markdown 编辑器。这里有几个我已经试过的。

 title=

你可以用 Markdown 做任何事情:给网站排版、编写书籍和撰写技术文档只是它的一些用途。我喜欢它创建富文本文档可以如此简单。每个人都有自己喜欢的 Markdown 编辑器。在我的 Markdown 之旅中,我使用了好几个。下面是我考虑过的五个 Markdown 编辑器。

Abricotine

Abricotine 是一个在 GPLv 下发布的开源编辑器。你可以手动输入格式,或者使用菜单插入 GitHub 风格的 Markdown。Abricotine 允许你在输入时预览文本元素,如标题、图片、数学、嵌入式视频和待办事项。该编辑器只能将文件导出为 HTML。你可以在 Linux、macOS 和 Windows 上使用 Abricotine。

 title=

MarkText

MarkText 是一个简单的 Markdown 编辑器。它有很多功能,而且在处理 Markdown 格式的文件方面做得很好。MarkText 也支持 GitHub 风格的 Markdown,它允许你添加表格和带有语法高亮的代码块。它支持实时预览,并且有一个简单的界面。MarkText 是在 MIT 下授权的。它支持 HTML 和 PDF 格式的输出。MarkText 可以在 Linux、macOS 和 Windows 上使用。

 title=

Ghostwriter

Ghostwriter 是一个用于 Linux 和 Windows 的 Markdown 编辑器。根据其网站用户的说法。“享受无干扰的写作体验,包括全屏模式和简洁的界面。有了 Markdown,你可以现在写,以后再格式化”。它有内置的默认的浅色和深色主题,或者你可以自己编写。你可以将文件实时按 HTML 预览,你可以直接复制和粘贴到博客中,或导出为其他格式。Ghostwriter 是在 GPLv3 下发布的。

 title=

Atom

Atom 被称为 21 世纪的可自定义文本编辑器。它也可以作为一个 Markdown 编辑器使用。它可以在 Linux、Windows 和 macOS上运行,并以 MIT 许可证发布。它支持 GitHub 风格的 Markdown,并且按下 Ctrl+Shift+M 可以打开一个预览面板,这样你就可以轻松地看到 HTML 预览。你可以通过创建一个文件并以 .md 文件扩展名保存来轻松入门。这告诉 Atom 它是一个 Markdown 文件。Atom 会自动应用正确的包和语法高亮。

 title=

VSCodium

VSCodium 是微软的 VSCode 编辑器的自由开源版本,没有内置在微软产品中的遥测技术。它以 MIT 许可证发布,并提供了 VSCode 的所有功能,而没有专有特性。除了其他功能外,VSCodium 还可以作为一个 Markdown 编辑器。创建一个新文件,点击 “选择一个语言”,选择 “Markdown”,然后开始写你的代码。通过按 Ctrl-Shift+V 轻松预览文本,然后再切换回编辑器。你也可以通过添加一个扩展来轻松地扩展 Markdown 编辑器。我最喜欢的插件是 Markdown editor,它是 MIT 许可证。

 title=

你最喜欢的 Markdown 编辑器是什么? 让我们在评论中知道。


via: https://opensource.com/article/21/10/markdown-editors

作者:Don Watkins 选题:lujun9972 译者:geekpi 校对:wxy

本文由 LCTT 原创编译,Linux中国 荣誉推出

很多时候我与 Markdown 打交道的方式是,先写完一个文件,然后把它转换成 HTML 或其他格式。也有些时候,需要创建一些新的文件。当我要写多个 Markdown 文件时,通常要把他们全部写完之后才转换它们。

我用 pandoc 来转换文件,它可以一次性地转换所有 Markdown 文件。

Markdown 格式的文件可以转换成 .html 文件,有时候我需要把它转换成其他格式,如 epub,这个时候 pandoc 就派上了用场。我更喜欢用命令行,因此本文我会首先介绍它,然而你还可以使用 VSCodium 在非命令行下完成转换。后面我也会介绍它。

使用 pandoc 把多个 Markdown 文件转换成其他格式(命令行方式)

你可以在 Ubuntu 及其他 Debian 系发行版本终端输入下面的命令来快速开始:

sudo apt-get install pandoc

本例中,在名为 md_test 目录下我有四个 Markdown 文件需要转换。

[email protected]:~/Documents/md_test$ ls -l *.md
-rw-r--r-- 1 bdyer bdyer 3374 Apr  7  2020 file01.md
-rw-r--r-- 1 bdyer bdyer  782 Apr  2 05:23 file02.md
-rw-r--r-- 1 bdyer bdyer 9257 Apr  2 05:21 file03.md
-rw-r--r-- 1 bdyer bdyer 9442 Apr  2 05:21 file04.md
[email protected]:~/Documents/md_test$

现在还没有 HTML 文件。现在我要对这些文件使用 pandoc。我会运行一行命令来实现:

  • 调用 pandoc
  • 读取 .md 文件并导出为 .html

下面是我要运行的命令:

for i in *.md ; do echo "$i" && pandoc -s $i -o $i.html ; done

如果你不太理解上面的命令中的 ;,可以参考 在 Linux 中一次执行多个命令

我执行命令后,运行结果如下:

[email protected]:~/Documents/md_test$ for i in *.md ; do echo "$i" && pandoc -s $i -o $i.html ; done
file01.md
file02.md
file03.md
file04.md
[email protected]:~/Documents/md_test$

让我再使用一次 ls 命令来看看是否已经生成了 HTML 文件:

[email protected]:~/Documents/md_test$ ls -l *.html
-rw-r--r-- 1 bdyer bdyer  4291 Apr  2 06:08 file01.md.html
-rw-r--r-- 1 bdyer bdyer  1781 Apr  2 06:08 file02.md.html
-rw-r--r-- 1 bdyer bdyer 10272 Apr  2 06:08 file03.md.html
-rw-r--r-- 1 bdyer bdyer 10502 Apr  2 06:08 file04.md.html
[email protected]:~/Documents/md_test$

转换很成功,现在你已经有了四个 HTML 文件,它们可以用在 Web 服务器上。

pandoc 功能相当多,你可以通过指定输出文件的扩展名来把 Markdown 文件转换成其他支持的格式。不难理解它为什么会被认为是最好的写作开源工具

使用 VSCodium 把 Markdown 文件转换成 HTML(GUI 方式)

就像我们前面说的那样,我通常使用命令行,但是对于批量转换,我不会使用命令行,你也不必。VSCode 或 VSCodium 可以完成批量操作。你只需要安装一个 Markdown-All-in-One 扩展,就可以在一次运行中转换多个 Markdown 文件。

有两种方式安装这个扩展:

  • VSCodium 的终端
  • VSCodium 的插件管理器

通过 VSCodium 的终端安装该扩展:

  1. 点击菜单栏的 终端。会打开终端面板
  2. 输入,或复制下面的命令并粘贴到终端
codium --install-extension yzhang.markdown-all-in-one

注意:如果你使用的 VSCode 而不是 VSCodium,那么请把上面命令中的 codium 替换为 code

第二种安装方式是通过 VSCodium 的插件/扩展管理器:

  1. 点击 VSCodium 窗口左侧的块区域。会出现一个扩展列表,列表最上面有一个搜索框。
  2. 在搜索框中输入 “Markdown All in One”。在列表最上面会出现该扩展。点击 “安装” 按钮来安装它。如果你已经安装过,在安装按钮的位置会出现一个齿轮图标。

安装完成后,你可以打开含有需要转换的 Markdown 文件的文件夹。

点击 VSCodium 窗口左侧的纸张图标。你可以选择文件夹。打开文件夹后,你需要打开至少一个文件。你也可以打开多个文件,但是最少打开一个。

当打开文件后,按下 CTRL+SHIFT+P 唤起命令面板。然后,在出现的搜索框中输入 Markdown。当你输入时,会出现一列 Markdown 相关的命令。其中有一个是 Markdown All in One: Print documents to HTML 命令。点击它:

你需要选择一个文件夹来存放这些文件。它会自动创建一个 out 目录,转换后的 HTML 文件会存放在 out 目录下。从下面的图中可以看到,Markdown 文档被转换成了 HTML 文件。在这里,你可以打开、查看、编辑这些 HTML 文件。

在等待转换 Markdown 文件时,你可以更多地集中精力在写作上。当你准备好时,你就可以把它们转换成 HTML —— 你可以通过两种方式转换它们。


via: https://itsfoss.com/convert-markdown-files/

作者:Bill Dyer 选题:lujun9972 译者:lxbwolf 校对:wxy

本文由 LCTT 原创编译,Linux中国 荣誉推出

Nextcloud 拥有流行的 Markdown 文件的最流畅的编辑器之一,它有很多方便和直观的功能。

纯文本的好处是,没有额外的针对计算机的信息会杂乱无章地出现在原本供人类阅读的文字中。计算机的好处是它们是可编程的,因此只要我们人类同意在写作时遵循非常特定的惯例,我们就可以对计算机进行编程,将人类可读的文本解释为秘密指令。例如,我们在一个词的周围打上两个星号,不仅可以给人类一个视觉上的提示,说明这个词很重要,我们还可给计算机编程让它用粗体显示这个词。

这正是 Markdown 背后的理论和实践,这种流行的纯文本格式向作者们承诺,只要\_他们\_使用特定的纯文本约定,那么他们的文本就会以特定的风格呈现。

传统中,这意味着作者用纯文本写作,直到文本被传给转换器应用(最初是 markdown.pl),才会看到漂亮的样式,但 Nextcloud 的 Markdown 编辑器应用改变了这一点。

通过 Nextcloud 的 Markdown 编辑器,你可以一边输入纯文本,一边看到它渲染后的样式。这对于那些要努力记住 Markdown 有时令人困惑的符号的作者们无异于是救星(方括号是在小括号中的超链接之前还是之后?)。而且更好的是,它运行在 Nextcloud 中,所以你可以在任何地方使用它。

安装

要使用 Nextcloud 的 Markdown 编辑器,你必须安装 Nextcloud。好消息是,Nextcloud 非常\_容易\_安装。我已经在树莓派、共享服务器、甚至作为一个本地应用安装了它(这是愚蠢的,不要这样做)。如果你不相信自己的能力,你甚至可以依靠 Turnkey Linux 来帮你完成这些难关,否则就直接从 Nextcloud.com 购买托管服务。在你安装 Nextcloud 后,添加应用就很简单了。点击 Nextcloud 界面右上角的用户图标,选择 Apps。找到 Office and Text 类别,点击安装并启用 Markdown Editor

 title=

启动

激活后,Markdown 编辑器会与 Nextcloud 文件中任何以 .md 结尾的文件相关联,当你打开一个 Markdown 文件时,你就会启动 Markdown 编辑器。

使用 Markdown 编辑器

Markdown 编辑器包含了一个大的文本区域供你输入,以及一个沿着顶部的工具栏。

 title=

工具栏包含了文字处理器的基本功能:用粗体、斜体和删除线设计文本样式、创建标题和段落、列表等等。

如果你了解 Markdown,这些功能中的许多可以在你输入时自动调用。如果你不熟悉 Markdown,那么工具栏或常用的键盘快捷键(Ctrl+B 表示粗体,Ctrl+I 表示斜体等等)可以帮助你设计文本的样式。

Markdown 编辑器的工作方式的最好的一点是,它真正做到了使人人满意:如果你想以 Markdown 格式输入,那么它就会接受它并立即将其转化为视觉样式;如果你不想操心 Markdown 语法,那么当你使用键盘快捷键或工具栏按钮时,它就会为你生成样式。无论哪种方式,你永远不会看到 Markdown 语法格式,但你也永远不会失去它。这是一个完美的折中方案。

它也是一个非常聪明的编辑器。当你选择一个单词时,它会为你创建一个超链接,它能快速流畅地自动转换 Markdown,而且它知道一些不同“风格”的 Markdown 语法(主要是 Commonmark,但也有传统的 Markdown、Github Markdown,等等)。

 title=

尝试 Nextcloud

我用过几个 Markdown 预览应用,Nextcloud 的 Markdown 编辑器是最流畅的一个。它尊重用户,并为显示 Markdown 做了最基本的工作,所以它的转换速度很快,也很准确。因为它是 Nextcloud 中的一个应用,你还可以获得这样的好处:你的作品可以即时保存在自己的私有的开源云上,并进行版本控制。没有比这更好的文本编辑器了。


via: https://opensource.com/article/20/12/nextcloud-markdown

作者:Seth Kenlon 选题:lujun9972 译者:geekpi 校对:wxy

本文由 LCTT 原创编译,Linux中国 荣誉推出

Markdown 是一种有用的轻量级标记语言,很多人喜欢用它来编写文档或做网页发布。很多人都使用 Markdown 来写文章。

几个适用于 Linux 的 Markdown 编辑器,你可以安装并使用。

但是,如果你不想在你的系统上安装另一个程序怎么办?也许你暂时使用的系统无法安装一个应用程序?也许你只是想要一个能让你实时协作的 Markdown 编辑器?

无论你的需求是什么,在线 Markdown 编辑器通过提供协作功能、发布集成、笔记同步和一些在线功能,让很多事情变得简单。

因此,我整理了一份在线 Markdown 编辑器列表。

免费的在线 Markdown 编辑器

我尽量把重点放在代码开源的在线 Markdown 编辑器上。你可以使用它们的官方网站或将其部署到你的服务器上。

注:本列表没有特定排名顺序。

1、StackEdit

StackEdit 是目前最流行的开源在线 Markdown 编辑器之一。

它提供了一个很好的用户界面,并有一堆有用的功能。协作能力、同步能力,以及能够将你的文件发布/保存到 Blogger、WordPress、GitHub 和其他一些服务是 StackEdit 的一些关键功能。

不要忘了,你还可以使用一些 Markdown 扩展来支持 LaTeX 数学表达式、UML 图等。它的界面是一个所见即所得的编辑器,可以让你轻松使用 Markdown。它还可以离线工作,如果你需要的话,它还提供了一个 chrome 应用程序和扩展。

在 StackEdit 上导入/导出文件也很容易。如果你需要在你的服务器上托管它,你可以看看它在 GitHub 上的源代码,了解更多细节。

2、Dillinger

Dillinger 也是一个有趣的开源在线 Markdown 编辑器。与 StackEdit 类似,你也可以与 Dropbox、GitHub、Medium、Google Drive、Bitbucket 和 OneDrive 链接并保存文件。

你也可以选择在需要时简单地导入/导出文件。Dillinger 的用户界面比你在 StackEdit 上看到的更简单,但它也可以工作。与 StackEdit 不同的是,你没有 LaTeX 表达式或图表的 Markdown 扩展支持,如果你只是需要一个简单的在线 Markdown 编辑器,这是一个不错的选择。

如果你需要,你可以选择将它部署在服务器上的 Docker 容器中。关于它的更多技术细节,你不妨看看它的 GitHub 页面

3、Write.as

Write.as 基于该团队开发的自由开源软件 WriteFreely,所以如果你愿意的话,你可以简单地把它托管在自己的服务器上免费使用它。

你也可以使用 Write.as 服务作为一个具有基本功能的免费在线 Markdown 编辑器。为了使它发挥最大的作用,你可能想选购一份付费订阅。付费的功能包括自定义主题、新闻通讯、照片托管和多个博客等等。

它支持 Markdown,可以让 MastodonActivityPubPleroma 上的任何人轻松关注和分享你的博客文章。

你可以在它的 GitHub 页面上探索更多关于 WriteFreely 的信息,或者使用 Write.as 开始。

4、Editor.md

这是一个有趣的开源 Markdown 编辑器,还可以嵌入到自己的网页上。

它支持实时预览、GitHub 风格的 Markdown,它有一个所见即所得的编辑器以及一堆有用的功能。除了基本的 Markdown 支持外,它还支持表情符、LaTeX 表达式、流程图等。

你也可以选择自己托管,更多信息请看它的 GitHub 页面

5、CodiMD

CodiMD 从一开始就不是一个成熟的在线服务。但是,它是一个开源项目,通过托管在服务器上,你可以实时协作文档或笔记。

它基于 HackMD 的源代码,并提供了一个演示实例来提供测试。我个人很喜欢它还提供了一个黑暗模式,而且很容易使用。

对于它未来的发布版本(在写这篇文章的时候),它将改名为 “HedgeDoc”。

你可以在它的 GitHub 页面上找到所有关于通过 Docker/Kubernetes 在服务器上部署它的相关信息以及其他手动配置选项。

6、Wri.pe

Wri.pe 是一款简单的开源在线 Markdown 编辑器,虽然已经不再维护,但它仍然活着而且可用。

它的特点是实时预览和可以导出或保存你的笔记到 Dropbox/Evernote。考虑到它没有积极维护,你可能不会依赖它,但当我测试它时,它和预期一样可以工作。

你可以看看它的 GitHub 页面或官方网站来了解更多关于它的信息。

附带提名

下面是一些提供 Markdown 访问的工具。

Markdown Web Dingus

这是由 Markdown 语言的创造者提供的一个简单而免费的在线 Markdown 编辑器。它并不是一个成熟的在线编辑器,也不支持导入/导出,

但是,如果你只是想要一个在线编辑器来预览你的 Markdown 代码,这可能是一个不错的选择。不仅仅局限于编辑器,你还可以在网站的侧边栏得到一个语法速查表。所以,你也可以在这里尝试和学习。

Markdown Journal

Markdown JournalGitHub 上的一个有趣的开源项目,但已经停止开发了。你可以通过它的在线编辑器使用 Markdown 语言创建日记,并直接保存在你的 Dropbox 账户上。当我试图创建日志时,我注意到发生了内部服务器错误,但你可以了解一下它。

Etherpad

Etherpad 是另一个令人印象深刻的开源在线编辑器,但它并没有开箱即用的 Markdown 支持。你可能会注意到通过一些插件可以在你的服务器上启用 Markdown 编辑,但还不够完美。所以,你可能要注意一点。它有一个公共实例的列表,也可以尝试一下。

总结

考虑到很多在线编辑器、CMS 和记事本服务都支持 Markdown,如果你想把它发布到网站上,像 WordPress 这样的服务/应用也是一个不错的选择。

你更喜欢用哪个 Markdown 编辑器?我是否错过了你最喜欢的东西?请在下面的评论中告诉我。


via: https://itsfoss.com/online-markdown-editors/

作者:Ankush Das 选题:lujun9972 译者:wxy 校对:wxy

本文由 LCTT 原创编译,Linux中国 荣誉推出

命令行 Markdown 工具快速、强大、灵活。以下是 4 个值得试一下的工具。

(在 Linux 上)在处理 Markdown 格式的文件时,命令行工具会占据主导地位。它们轻巧、快速、强大、灵活,它们大多数都遵循 Unix 哲学只做好一件事。

看一下这四个程序,它们可以帮助你在命令行中更有效地处理 Markdown 文件。

mdless

如果你使用过一段时间的 Linux 命令行,那么你可能对名为 less 的文本查看器很熟悉。当然,你可以使用 less 查看 Markdown 文件,但结果有点枯燥。如何在终端中查看 Markdown 文件效果更好一点?来使用 mdless

 title=

你可以使用键盘上的箭头键四处移动,并且 mdless 提供了很好的搜索功能。

mdless 不仅会显示文本,而且还会渲染标题、粗体和斜体等格式。它还可以显示表格并语法高亮代码块。你还可以创建一个或多个主题文件来定制 mdless 的外观。

Markdown lint 工具

你在快速输入时会犯错误。如果你在使用 Markdown(或其他任何标记语言)时丢失了一些格式,那么在将文件转换为另一种格式时可能会有问题。

程序员通常使用名为 linter 的工具来检查语法是否正确。你可以使用 Markdown lint 工具对 Markdown 执行相同的操作。

在你对 Markdown 文件运行该工具时,它会根据规则集检查格式。这些规则控制着文档的结构,包括标题级别的顺序、不正确的缩进和间距、代码块问题、文件中存在 HTML 等等。

 title=

规则可能有点严格。但是,在将文件转换为其他格式之前对文件运行 Markdown lint 工具可以防止由于格式错误或不一致引起的麻烦。

mdmerge

合并任何类型的文件可能会很痛苦。例如,我在整理一本电子书。它是一篇文章集,最初发布在我的每周邮件中。这些文章都放在单独的文件中,作为受虐狂,我以凌乱、手动的方式将它们组合在一起。

我希望在开始这个项目之前就知道 mdmerge。这样我可以节省很多时间和精力。

mdmerge,你可能已经从名称中猜到了它的作用,它将两个或多个 Markdown 文件合并为一个文件。你无需在命令行中输入文件名。相反,你可以将它们添加到名为 book.txt 的文件中,并将其用作 mdmerge 的输入文件。

这并不是 mdmerge 能做的一切。你可以添加对另一个文档的引用(使用 Markdown 格式引用或一段源代码),然后将其放入主文档中。这样一来,你就可以创建针对特定受众定制的主文档

mdmerge 不会是你经常使用的程序。但当你需要时,你会很高兴硬盘上有它。

bashblog

严格说 bashblog 并不是 Markdown 工具。它获取 Markdown 文件,并使用它们来构建简单的博客或网站。你可以将 bashblog 视为静态站点生成器,但是它没有很多脆弱的依赖关系。一切几乎都在一个不到 50KB 的 shell 脚本中。

要使用 bashblog,只需在计算机上安装 Markdown 处理器即可。在此,你可以编辑 Shell 脚本添加有关博客的信息,例如标题、名字、社交媒体链接等。然后运行该脚本。之后会在默认文本编辑器中新建一篇文章。开始输入。

保存文章后,你可以发布它或将其另存为草稿。如果你选择发布文章,那么 bashblog 会将你的博客、文章和所有内容生成为一组 HTML 文件,你可以将它们上传到 Web 服务器。

它开箱即用,你的博客或许会平淡无奇,但可以使用。你可以根据自己喜好编辑站点的 CSS 文件来改变外观。

 title=

Pandoc 如何?

当然,Panddoc 是一个非常强大的工具,可以将 Markdown 文件转换为其他标记语言。但是,在命令行上使用 Markdown 要比 Pandoc 多。

如果你需要 Pandoc,请查看我们发布的文章:


via: https://opensource.com/article/20/3/markdown-apps-linux-command-line

作者:Scott Nesbitt 选题:lujun9972 译者:geekpi 校对:wxy

本文由 LCTT 原创编译,Linux中国 荣誉推出

一次编辑便可将文本转换为多种格式。下面是如何开始使用 Markdown。

在很长一段时间里,我发现我在 GitLab 和 GitHub 上看到的所有文件都带有 .md 扩展名,这是专门为开发人员编写的文件类型。几周前,当我开始使用 Markdown 时,我的观念发生了变化。它很快成为我日常工作中最重要的工具。

Markdown 使我的生活更简易。我只需要在已经编写的代码中添加一些符号,并且在浏览器扩展或开源程序的帮助下,即可将文本转换为各种常用格式,如 ODT、电子邮件(稍后将详细介绍)、PDF 和 EPUB。

什么是 Markdown?

来自 维基百科的友情提示:

Markdown 是一种轻量级标记语言,具有纯文本格式语法。

这意味着通过在文本中使用一些额外的符号,Markdown 可以帮助你创建具有特定结构和格式的文档。当你以纯文本(例如,在记事本应用程序中)做笔记时,没有任何东西表明哪个文本应该是粗体或斜体。在普通文本中,你在写链接时需要将一个链接写为 “http://example.com ”,或者写为 “example.com”,又或“访问网站(example.com)”。这样没有内在的一致性。

但是如果你按照 Markdown 的方式编写,你的文本就有了内在的一致性。计算机喜欢一致性,因为这使得它们能够遵循严格的指令而不用担心异常。

相信我;一旦你学会使用 Markdown,每一项写作任务在某种程度上都会比以前更容易、更好。让我们开始吧。

Markdown 基础

以下是使用 Markdown 的基础语法。

1、创建一个以 .md 扩展名结尾的文本文件(例如,example.md)。你可以使用任何文本编辑器(甚至像 LibreOffice 或 Microsoft word 这样的文字处理程序亦可),只要记住将其保存为文本文件。

 title=

2、想写什么就写什么,就像往常一样:

Lorem ipsum

Consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.
Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

De Finibus Bonorum et Malorum

Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo.
Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt.

  Neque porro quisquam est, qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit, sed quia non numquam eius modi tempora incidunt ut labore et dolore magnam aliquam quaerat voluptatem.

(LCTT 译注:上述这段“Lorem ipsum”,中文又称“乱数假文”,是一篇常用于排版设计领域的拉丁文文章,主要目的为测试文章或文字在不同字型、版型下看起来的效果。)

3、确保在段落之间留有空行。如果你习惯写商务信函或传统散文,这可能会觉得不自然,因为那里段落只有一行,甚至在第一个单词前还有一个缩进。对于 Markdown,空行(一些文字处理程序使用 ,称为Pilcrow 符号)保证在创建一个新段落应用另一种格式(如 HTML)。

4、指定标题和副标题。对于文档的标题,在文本前面添加一个井号或散列符号(#)和一个空格(例如 # Lorem ipsum)。第一个副标题级别使用两个(## De Finibus Bonorum et Malorum),下一个级别使用三个(### 第三个副标题),以此类推。注意,在井号和第一个单词之间有一个空格。

# Lorem ipsum

Consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.
Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

## De Finibus Bonorum et Malorum

Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo.
Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt.

  Neque porro quisquam est, qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit, sed quia non numquam eius modi tempora incidunt ut labore et dolore magnam aliquam quaerat voluptatem.

5、如果你想使用粗体字符,只需将字母放在两个星号之间,没有空格:**对应的文本将以粗体显示**

 title=

6、对于斜体,将文本放在没有空格的下划线符号之间:_我希望这个本文以斜体显示_。(LCTT 译注:有的 Markdown 流派会将用下划线引起来的字符串视作下划线文本,而单个星号 * 引用起来的才视作斜体。从兼容性的角度看,使用星号比较兼容。)

 title=

7、要插入一个链接(像 Markdown Tutorial),把你想链接的文本放在括号里,URL 放在括号里,中间没有空格:[Markdown Tutorial](<https://www.markdowntutorial.com/>)

 title=

8、块引用是用大于号编写的(>)在你要引用的文本前加上大于符号和空格: > 名言引用

 title=

Markdown 教程和技巧

这些技巧可以帮助你上手 Markdown ,但它涵盖了很多功能,不仅仅是粗体、斜体和链接。学习 Markdown 的最好方法是使用它,但是我建议你花 15 分钟来学习这篇简单的 Markdown 教程,学以致用,勤加练习。

由于现代 Markdown 是对结构化文本概念的许多不同解释的融合,CommonMark 项目定义了一个规范,其中包含一组严格的规则,以使 Markdown 更加清晰。在编辑时手边准备一份符合 CommonMark 的快捷键列表可能会有帮助。

你能用 Markdown 做什么

Markdown 可以让你写任何你想写的东西,仅需一次编辑,就可以把它转换成几乎任何你想使用的格式。下面的示例演示如何将用 MD 编写简单的文本并转换为不同的格式。你不需要多种格式的文档-你可以仅仅编辑一次…然后拥有无限可能。

1、简单的笔记:你可以用 Markdown 编写你的笔记,并且在保存笔记时,开源笔记应用程序 Turtl 将解释你的文本文件并显示为对应的格式。你可以把笔记存储在任何地方!

 title=

2、PDF 文件:使用 Pandoc 应用程序,你可以使用一个简单的命令将 Markdown 文件转换为 PDF:

pandoc <file.md> -o <file.pdf>

 title=

3、Email:你还可以通过安装浏览器扩展 Markdown Here 将 Markdown 文本转换为 html 格式的电子邮件。要使用它,只需选择你的 Markdown 文本,在这里使用 Markdown 将其转换为 HTML,并使用你喜欢的电子邮件客户端发送消息。

 title=

现在就开始上手吧

你不需要一个特殊的应用程序来使用 Markdown,你只需要一个文本编辑器和上面的技巧。它与你已有的写作方式兼容;你所需要做的就是使用它,所以试试吧。


via: https://opensource.com/article/19/9/introduction-markdown

作者:Juan Islas 选题:lujun9972 译者:qfzy1233 校对:wxy

本文由 LCTT 原创编译,Linux中国 荣誉推出