• 简洁的 Markdown 文本编辑器 Typora


    简介

    Typora 是一款轻量级 Markdown 编辑器。它与其他 Markdown 编辑器的主要区别在于采用了即时渲染技术,将写作与预览窗口相结合,为用户提供所见即所得的编辑模式。Typora 支持 Markdown 的各种基础语法,快捷键操作,是一款非常易用的 Markdown 编辑器。

    此外,Typora 删除了预览窗口、模式切换程序、标记源代码的语法符号以及所有其他不必要的干扰,将它们替换为真正的实时预览功能,专注于内容本身。它拥有 Windows、macOS 客户端,界面简洁优美,可算作一款 Windows 下难得的好看、优美的客户端。

    总的来说,Typora 是一款功能强大、轻便简洁的 Markdown 编辑器,适合需要写作和编辑 Markdown 文档的用户使用。

    块元素

    段落和换行符

    段落只是一行或多行连续的文本。在 markdown 源代码中,段落由多个空行分隔。在Typora中,您只需按下 Return 即可创建新段落。

    Shift + Return 可创建单个换行符。但是,大多数 markdown 解析器将忽略单行中断,要使其他 markdown 解析器识别您的换行符,可以在行尾留下两个空格,或者插入
    .

    标题

    标题在行的开头使用1-6个#字符,对应于标题级别1-6。例如:

    # 这是一级标题
    
    ## 这是二级标题
    
    ###### 这是六级标题
    
    • 1
    • 2
    • 3
    • 4
    • 5

    在typora中,输入’#’后跟标题内容,按下 Return 键将创建标题。

    引用文字

    Markdown 使用电子邮件样式>字符进行块引用。它们表示为:

    > 这是一个有两段的块引用。这是第一段。
    >
    > 这是第二段。Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
    
    
    
    > 这是另一个只有一个段落的块引用。有三个空行分隔两个块引用。
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7

    在typora中,只需输入’>’后跟引用内容即可生成块引用。Typora将为您插入正确的“>”或换行符。通过添加额外级别的“>”允许在块引用内嵌入另一个块引用。

    列表

    输入 * list item 1 将创建一个无序列表,该 * 符号可以替换为 +-.

    输入 1. list item 1 将创建一个有序列表,其 markdown 源代码如下:

    ## 无序列表
    *   红色
    *   绿色
    *   蓝色
    
    ## 有序列表
    1.  红色
    2. 	绿色
    3.	蓝色
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9

    任务列表

    任务列表是标记为[ ]或[x](未完成或完成)的项目的列表。例如:

    - [ ] 这是一个任务列表项
    - [ ] 需要在前面使用列表的语法
    - [ ] normal **formatting**, @mentions, #1234 refs
    - [ ] 未完成
    - [x] 完成
    
    • 1
    • 2
    • 3
    • 4
    • 5

    您可以通过单击项目前面的复选框来更改完成/未完成状态。

    (栅栏式)代码块

    Typora仅支持 Github Flavored Markdown 中的栅栏式代码块。不支持 markdown 中的原始代码块。

    使用栅栏式代码块很简单:输入```之后输入一个可选的语言标识符,然后按return键后输入代码,我们将通过语法高亮显示它:

    这是一个例子:
    
    ```
    function test() {
      console.log("notice the blank line before this function?");
    }
    ```
    
    语法高亮:
    ```ruby
    require 'redcarpet'
    markdown = Redcarpet.new("Hello World!")
    puts markdown.to_html
    ```
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14

    数学块

    您可以使用 MathJax 渲染 LaTeX 数学表达式。

    要添加数学表达式,请输入并按“返回”键。这将触发一个接受 Tex/LaTex 源的输入字段。例如:$$

    [\mathbf{V}_1 \times \mathbf{V}_2 =

    |ijk XuYu0 XvYv0 |" role="presentation" style="text-align: center; position: relative;">|ijk XuYu0 XvYv0 |
    ]
    在 markdown 源文件中,math 块是一个 LaTeX 表达式,由一对“$$”标记包装:

    V 1 × V 2 = ∣ i j k ∂ X ∂ u ∂ Y ∂ u 0 ∂ X ∂ v ∂ Y ∂ v 0 ∣ \mathbf{V}_1 \times \mathbf{V}_2 =

    |ijkXuYu0XvYv0|" role="presentation" style="position: relative;">|ijkXuYu0XvYv0|
    V1×V2= iuXvXjuYvYk00
    您可以在此处找到更多详细信息。

    表格

    输入 | First Header | Second Header | 并按下 return 键将创建一个包含两列的表。

    创建表后,焦点在该表上将弹出一个表格工具栏,您可以在其中调整表格,对齐或删除表格。您还可以使用上下文菜单来复制和添加/删除列/行。

    可以跳过以下描述,因为表格的 markdown 源代码是由typora自动生成的。

    在 markdown 源代码中,它们看起来像这样:

    | First Header  | Second Header |
    | ------------- | ------------- |
    | Content Cell  | Content Cell  |
    | Content Cell  | Content Cell  |
    
    • 1
    • 2
    • 3
    • 4

    您还可以在表格中包括内联 Markdown 语法,例如链接,粗体,斜体或删除线。

    最后,通过在标题行中包含冒号:您可以将文本定义为左对齐,右对齐或居中对齐:

    | Left-Aligned  | Center Aligned  | Right Aligned |
    | :------------ |:---------------:| -----:|
    | col 3 is      | some wordy text | $1600 |
    | col 2 is      | centered        |   $12 |
    | zebra stripes | are neat        |    $1 |
    
    • 1
    • 2
    • 3
    • 4
    • 5

    最左侧的冒号表示左对齐的列; 最右侧的冒号表示右对齐的列; 两侧的冒号表示中心对齐的列。

    脚注

    您可以像这样创建脚注[^footnote].
    
    [^footnote]: Here is the *text* of the **footnote**.
    
    • 1
    • 2
    • 3

    将产生:

    您可以像这样创建脚注1.

    鼠标移动到‘footnote’上标中查看脚注的内容。

    水平线

    输入 ***--- 在空行上按 return 键将绘制一条水平线。


    YAML Front Matter

    Typora 现在支持 YAML Front Matter 。 在文章顶部输入 --- 然后按 Enter 键将引入一个,或者从菜单中插入一个元数据块。

    目录 (TOC)

    输入 [toc] 然后按 Return 键将创建一个“目录”部分,自动从文档内容中提取所有标题,其内容会自动更新。

    图表 (Sequence, Flowchart and Mermaid)

    Typora 支持, sequence, flowchart and mermaid, 使用前要先从偏好设置面板启用该功能。

    详细信息请参阅此 文档

    Span 元素

    在您输入后Span元素会被立即解析并呈现。在这些span元素上移动光标会将这些元素扩展为markdown源代码。以下将解释这些span元素的语法。

    链接

    Markdown 支持两种类型的链接:内联和引用。

    在这两种样式中,链接文本都写在[方括号]内。

    要创建内联链接,请在链接文本的结束方括号后立即使用一组常规括号。在常规括号内,输入URL地址,以及可选的用引号括起来的链接标题。例如:

    This is [an example](http://example.com/ "Title") inline link.
    
    [This link](http://example.net/) has no title attribute.
    
    • 1
    • 2
    • 3

    将产生:

    This is an example inline link. (

    This is )

    This link has no title attribute. (

    This link has no)

    内部链接

    您可以将常规括号内的 href 设置为文档内的某一个标题,这将创建一个书签,允许您在单击后跳转到该部分。例如:

    Command(在Windows上:Ctrl) + 单击 此链接 将跳转到标题 块元素处。 要查看如何编写,请移动光标或按住 键单击以将元素展开为 Markdown 源代码。

    参考链接

    参考样式链接使用第二组方括号,在其中放置您选择的标签以标识链接:

    This is [an example][id] reference-style link.
    
    然后,在文档中的任何位置,您可以单独定义链接标签,如下所示:
    
    [id]: http://example.com/  "Optional Title Here"
    
    • 1
    • 2
    • 3
    • 4
    • 5

    在typora中,它们将呈现为:

    This is an example reference-style link.

    隐式链接名称快捷方式允许您省略链接的名称,在这种情况下,链接文本本身将用作名称。只需使用一组空的方括号,例如,将“Google”一词链接到google.com网站,您只需写下:

    [Google][]
    然后定义链接:
    
    [Google]: http://google.com/
    
    • 1
    • 2
    • 3
    • 4

    在typora中单击链接将其展开以进行编辑,command + 单击将在 Web 浏览器中打开超链接。

    URL网址

    Typora允许您将 URL 作为链接插入,用 <括号括起来>

    成为 i@typora.io.

    Typora也将自动链接标准URL。例如: www.google.com.

    图片

    图像与链接类似, 但在链接语法之前需要添加额外的 ! 字符。 图像语法如下所示:

    ![替代文字](/path/to/img.jpg)
    
    ![替代文字](/path/to/img.jpg "可选标题")
    
    • 1
    • 2
    • 3

    您可以使用拖放操作从图像文件或浏览器来插入图像。并通过单击图像修改 markdown 源代码。如果图像在拖放时与当前编辑文档位于同一目录或子目录中,则将使用相对路径。

    有关图像的更多提示,请阅读 http://support.typora.io//Images/

    强调(斜体)

    Markdown 将星号 (*) 和下划线(_) 视为强调的指示。用一个 * or _ 包裹文本将使用HTML 标签包裹文本。例如:

    *单个星号*
    
    _单个下划线_
    
    • 1
    • 2
    • 3

    输出:

    单个星号

    单个下划线

    GFM将忽略单词中的下划线,这通常用在代码和名称中,如下所示:

    wow_great_stuff

    do_this_and_do_that_and_another_thing.

    要在用作强调分隔符的位置生成文字星号或下划线,可以用反斜杠转义:

    \*这个文字被文字星号包围\*
    
    • 1

    Typora建议使用 * 号.

    粗体

    用两个 * 或 _ 包裹的文本将使用HTML 标签包裹,例如:

    **双星号**
    
    __双重下划线__
    
    • 1
    • 2
    • 3

    输出:

    双星号

    双重下划线

    Typora 建议使用 ** 号。

    代码

    要指示代码范围,请使用反引号(`)进行包裹。与预格式化的代码块不同,代码跨度表示正常段落中的代码。例如:

    使用`printf()`函数。
    
    • 1

    将产生:

    使用 printf() 函数。

    删除线

    GFM通过添加语法来创建删除线文本,标准的Markdown中缺少该文本。

    ~~错误的文字。~~ 变成 错误的文字。

    下划线

    下划线由原始HTML提供支持。

    下划线 变成 下划线

    表情符号 😄

    输入表情符号的语法是 :smile:

    用户可以通过 ESC 按键触发表情符号的自动完成建议,或者在偏好设置面板里启用后自动触发表情符号。此外,还支持直接从 Edit -> Emoji & Symbols 菜单栏输入UTF8表情符号字符。

    内联数学公式

    要使用此功能,首先,请在 偏好设置 面板 -> Markdown扩展语法 选项卡中启用它。然后使用 $ 来包裹TeX命令,例如: $\lim_{x \to \infty} \exp(-x) = 0$ 将呈现为LaTeX命令。

    要触发内联公式的预览提示功能:输入“$”, 然后按 ESC 键, 然后输入TeX命令, 预览工具提示将如下所示:

    在这里插入图片描述

    下标

    要使用此功能,首先,请在 偏好设置 面板 -> Markdown扩展语法 选项卡中启用它。然后用 ~ 来包裹下标内容,例如: H~2~O, X~long\ text~/

    上标

    要使用此功能,首先,请在 偏好设置 面板 -> Markdown扩展语法 选项卡中启用它。然后用 ^ 来包裹上标内容,例如: X^2^

    高亮

    要使用此功能,首先,请在 偏好设置 面板 -> Markdown扩展语法 选项卡中启用它。然后用 == 来包裹高亮内容,例如: ==highlight==

    HTML

    您可以使用HTML来设置纯 Markdown 不支持的内容,例如, this text is red 用于添加红色文本。

    嵌入内容

    有些网站提供基于iframe的嵌入代码,您也可以将其粘贴到Typora中,例如:

    
    
    • 1

    视频

    您可以使用 HTML标记嵌入视频,例如:

    • 1

    Typora 中的HTML 支持

    最新版本的 Typora 已经支持普通的 HTML 标签。

    内联 HTML 标记(如 )将在您输入其关闭标记后立即呈现,就像其他 Markdown 语法(如 或 .其他支持的标签呈现在单独的块中,可以轻松地在输出和 HTML 源代码之间切换,就像数学块一样。````**``__

    对于安全转换,无论您使用或属性如何,都不支持任何脚本。、 和 也不受支持。对于 iframe,允许在 里面使用脚本,但它将用属性包装,并且无法访问您的写作内容或本地文件。