Typora 入門指南

標題的自動編號

關于在哪里放置這些CSS,請按照添加自定義CSS。

此CSS片段會自動為文章中的所有標題添加編號,如下所示:

1.png

如何使用:

將以下內容添加到主題文件夾下的base.user.css或[theme] .user.css中。

/** initialize css counter */
#write {
    counter-reset: h1
}

h1 {
    counter-reset: h2
}

h2 {
    counter-reset: h3
}

h3 {
    counter-reset: h4
}

h4 {
    counter-reset: h5
}

h5 {
    counter-reset: h6
}

/** put counter result into headings */
#write h1:before {
    counter-increment: h1;
    content: counter(h1) ". "
}

#write h2:before {
    counter-increment: h2;
    content: counter(h1) "." counter(h2) ". "
}

#write h3:before,
h3.md-focus.md-heading:before /** override the default style for focused headings */ {
    counter-increment: h3;
    content: counter(h1) "." counter(h2) "." counter(h3) ". "
}

#write h4:before,
h4.md-focus.md-heading:before {
    counter-increment: h4;
    content: counter(h1) "." counter(h2) "." counter(h3) "." counter(h4) ". "
}

#write h5:before,
h5.md-focus.md-heading:before {
    counter-increment: h5;
    content: counter(h1) "." counter(h2) "." counter(h3) "." counter(h4) "." counter(h5) ". "
}

#write h6:before,
h6.md-focus.md-heading:before {
    counter-increment: h6;
    content: counter(h1) "." counter(h2) "." counter(h3) "." counter(h4) "." counter(h5) "." counter(h6) ". "
}

/** override the default style for focused headings */
#write>h3.md-focus:before,
#write>h4.md-focus:before,
#write>h5.md-focus:before,
#write>h6.md-focus:before,
h3.md-focus:before,
h4.md-focus:before,
h5.md-focus:before,
h6.md-focus:before {
    color: inherit;
    border: inherit;
    border-radius: inherit;
    position: inherit;
    left:initial;
    float: none;
    top:initial;
    font-size: inherit;
    padding-left: inherit;
    padding-right: inherit;
    vertical-align: inherit;
    font-weight: inherit;
    line-height: inherit;
}

自動編號TOC

如果您想要TOC實體也自動編號,您可以嘗試由Typora用戶發(fā)布的http://pastebin.com/NYugSbXk。

自動編號大綱面板。

可折疊大綱面板編號,并嘗試https://pastebin.com/XmYgBbaz。

代碼塊樣式/主題

關于在哪里放置這些CSS,請按照添加自定義CSS。

Typora使用CodeMirror在代碼圍欄中突出顯示語法。Typora中的代碼圍欄cm-s-inner用作其主題類。

要將CodeMirror主題移植到Typora中,例如material.css,您可以:

  1. 復制并粘貼到主題文件夾中base.user.css[theme].user.css下,并將其CodeMirror主題類名替換cm-s-inner為,例如,將原始文件中類名.cm-s-material更改為.cm-s-inner。
  2. 在CodeMirror渲染之前,代碼圍欄具有類似的結構<pre class="md-fences"></pre>。因此,還請將字體系列,顏色和背景等基本樣式應用到.md-fences選擇器中。

所以最終的CSS會是

/** ported from https://codemirror.net/theme/material.css **/
/*

    Name:       material
    Author:     Michael Kaminsky (http://github.com/mkaminsky11)

    Original material color scheme by Mattia Astorino (https://github.com/equinusocio/material-theme)

*/

.cm-s-inner {
  background-color: #263238;
  color: rgba(233, 237, 237, 1);
}
.cm-s-inner .CodeMirror-gutters {
  background: #263238;
  color: rgb(83,127,126);
  border: none;
}
.cm-s-inner .CodeMirror-guttermarker, .cm-s-inner .CodeMirror-guttermarker-subtle, .cm-s-inner .CodeMirror-linenumber { color: rgb(83,127,126); }
.cm-s-inner .CodeMirror-cursor { border-left: 1px solid #f8f8f0; }
.cm-s-inner div.CodeMirror-selected { background: rgba(255, 255, 255, 0.15); }
.cm-s-inner.CodeMirror-focused div.CodeMirror-selected { background: rgba(255, 255, 255, 0.10); }
.cm-s-inner .CodeMirror-line::selection, .cm-s-inner .CodeMirror-line > span::selection, .cm-s-inner .CodeMirror-line > span > span::selection { background: rgba(255, 255, 255, 0.10); }
.cm-s-inner .CodeMirror-line::-moz-selection, .cm-s-inner .CodeMirror-line > span::-moz-selection, .cm-s-inner .CodeMirror-line > span > span::-moz-selection { background: rgba(255, 255, 255, 0.10); }

.cm-s-inner .CodeMirror-activeline-background { background: rgba(0, 0, 0, 0); }
.cm-s-inner .cm-keyword { color: rgba(199, 146, 234, 1); }
.cm-s-inner .cm-operator { color: rgba(233, 237, 237, 1); }
.cm-s-inner .cm-variable-2 { color: #80CBC4; }
.cm-s-inner .cm-variable-3 { color: #82B1FF; }
.cm-s-inner .cm-builtin { color: #DECB6B; }
.cm-s-inner .cm-atom { color: #F77669; }
.cm-s-inner .cm-number { color: #F77669; }
.cm-s-inner .cm-def { color: rgba(233, 237, 237, 1); }
.cm-s-inner .cm-string { color: #C3E88D; }
.cm-s-inner .cm-string-2 { color: #80CBC4; }
.cm-s-inner .cm-comment { color: #546E7A; }
.cm-s-inner .cm-variable { color: #82B1FF; }
.cm-s-inner .cm-tag { color: #80CBC4; }
.cm-s-inner .cm-meta { color: #80CBC4; }
.cm-s-inner .cm-attribute { color: #FFCB6B; }
.cm-s-inner .cm-property { color: #80CBAE; }
.cm-s-inner .cm-qualifier { color: #DECB6B; }
.cm-s-inner .cm-variable-3 { color: #DECB6B; }
.cm-s-inner .cm-tag { color: rgba(255, 83, 112, 1); }
.cm-s-inner .cm-error {
  color: rgba(255, 255, 255, 1.0);
  background-color: #EC5F67;
}
.cm-s-inner .CodeMirror-matchingbracket {
  text-decoration: underline;
  color: white !important;
}

/**apply to code fences with plan text**/
.md-fences {
  background-color: #263238;
  color: rgba(233, 237, 237, 1);
  border: none;
}

.md-fences .code-tooltip {
  background-color: #263238;
}
Snip20160623_11.png

您也可以按照上面的示例編寫自己的CSS樣式以進行語法突出顯示。

請注意,cm-s-inner這僅適用于代碼圍欄,不會影響源代碼模式中的markdown語法指示燈。并非所有CSS屬性都將應用于源代碼模式中的代碼柵欄。

自定義字體

關于在哪里放置這些CSS,請按照添加自定義CSS。

Typora中的自定義字體由CSS設置。例如,base.user.css在主題文件夾下追加以下內容

body {
  font-family: Courier;
}

將覆蓋當前主題中的字體設置,并應用系統(tǒng)字體Courier,并使編輯區(qū)域如下所示:

1-1554172058255.png


您還可以使用Web字體,例如:

@import url(https://fonts.googleapis.com/css?family=Oxygen);

body {
 font-family: 'Oxygen', sans-serif; 
}

但是為了在加載時使字體更快或在無法訪問互聯(lián)網(wǎng)時使用它,我們建議您下載它并放在Typora的主題文件夾下。

例如,如果您從谷歌字體下載woff2文件并將它們放在[typora-theme-folder]/fonts目錄下,那么您可以使用CSS,如:

/* latin */
@font-face {
  font-family: 'Oxygen';
  font-style: normal;
  font-weight: 400;
  src: local('Oxygen'), local('Oxygen-Regular'),url('./fonts/Oxygen400.woff2') format('woff2');
}

/* latin */
@font-face {
  font-family: 'Oxygen';
  font-style: normal;
  font-weight: 700;
  src: local('Oxygen Bold'), local('Oxygen-Bold'), url('./fonts/Oxygen700.woff2') format('woff2');
}

body {
 font-family: 'Oxygen', sans-serif; 
}

應用字體。

更改字體大小

更改字體大小的更快捷方法是在首選項面板中執(zhí)行此操作。在macOS上,“字體大小”位于首選項面板的“常規(guī)”部分。在Window / Linux上,它位于“Appearance”部分下,您還可以使用press Ctrl+F在首選項面板中搜索它。

此選項需要您使用的主題支持。如果您正在制作主題css,請使用rem字體單位確保此選項有效。

Screen Shot 2019-01-25 at 22.18.21.png

換背景

下面的一些CSS樣式適用于最新版本的Typora(在macOS上> = 0.9.9.6,在Windows上> = 0.9.13)。關于在哪里放置這些CSS,請按照添加自定義CSS。

就個人而言,我不建議用戶為文本編輯器設置背景,但如果你仍然想要這樣,你可以按照這篇文章做。

例如,為Typora添加筆記本背景。圖像從此處拍攝,并復制到Typora的主題文件夾下。

CSS代碼如下:

content {
  background: url(./fzm-seamless.notebook.texture-14.png);
  background-repeat: repeat;
}

#write {
  padding-left: 120px; /*adjust writing area position*/
}

body {
  background: #F3F3F3; 
  /*Please set this background color as close to the background image as possible.
  titlebar for seamless window on macOS will use this background color. 
  typora for Win/Linux will use this to judge whether typora is in dark mode or light mode*/
}

/**Other css may needed to adjust UI components**/

結果如下:

Snip20160625_1.png

另一個例子:

Snip20160625_2.png
sscontent {
  background-image: url(http://localhost:4000/media/background/crashed_ship_by_hiddenvortexdesigns-da57nk8.jpg);
  background-repeat: repeat;
  background-position: -52px;
}

#write {
  margin-top: 24px;
  background-color: rgba(255, 255, 255, 0.68);
  margin-bottom: 24px;
  min-height: calc(100% - 48px);
}

body {
  background-color: #8F9D9A;
}

/**Other CSS to adjuest UI components*/

添加自定義CSS

此功能要求Windows上的Typora晚于0.9.12或macOS上的0.9.9.5.1

打開主題文件夾

打開首選項面板,然后單擊“外觀”部分下名為“打開主題文件夾”的按鈕,將在Finder /資源管理器中打開Typora的主題文件夾。

您可以在此處添加自定義主題(將有其他文檔介紹如何查找/安裝/編寫主題)。

但有時,您可能只想修改CSS,如更改字體或增加書寫區(qū)域,并將其應用于所有主題或當前主題而無需編寫全新的主題文件,本文檔將向您展示操作方法。

將自定義CSS附加到所有主題或其他主題

Typora將按以下順序加載CSS文件:

  1. Typora的基本款式。
  2. 當前主題的CSS。
  3. 主題文件夾下base.user.css
  4. 在主題文件夾下{current-theme}.user.css。如果您選擇Github作為主題,那么github.user.css也將加載。

如果它們不存在,您可以在主題文件夾下創(chuàng)建base.user.css{current-theme}.user.css。

如果要更改CSS樣式并將其應用于所有主題,則應修改base.user.css并附加自己的CSS,因此無論選擇何種主題,您的CSS樣式仍將加載并應用。

如果要修改特定主題的某些CSS,例如“新聞紙”,則可以創(chuàng)建newsprint.user.css并附加所需的CSS。我們不建議您直接修改主題文件的原因如下:

  1. 安裝Typora后可用的默認主題可能會在您更新Typora時同時更新。默認主題的更新邏輯只是:新版本的主題文件替換主題文件夾下的現(xiàn)有主題文件,因此如果將Typora更新為默認CSS文件,則修改后的修改可能會消失。
  2. 其他人開發(fā)的主題也可能在未來發(fā)生變化。如果他們更改了他們的CSS文件,您可以用舊文件替換他們的新文件,而不必擔心。如果將它們放在其他文件({current-theme}.user.css)中,您的修改將會消失。

但是如果你使用自己的CSS主題,那么直接修改它也行。

注意: {current-theme}.user.css中的{current-theme}應該(區(qū)分大小寫)與當前主題的文件名部分相同。例如,“GitHub”主題的CSS文件是github.css,因此文件名部分是“github”而不是“Github”。

調試CSS

您可以打開Chrome / Safari DevTools來調試元素樣式。

  • 在macOS上,您可以打開Safari,并從Develop- > your devide name- > Typora- > Typora菜單項打開DevTools 。
  • 在Windows / Linux上,您可以從View- > Toggle DevTools菜單項打開DevTools 。

打開Sublime(macOS)md

感謝Asoul,他創(chuàng)建了一個sublime插件,允許用戶在macOS上從Sublime 2/3打開Typora中的當前文件。

screenshot.png

安裝說明

包安裝程序

  • 安裝Sublime Package Control
  • 從命令選項板中選擇“包控制:安裝包”(super+shift+p
  • 找到“Typora.app Markdown”并選擇

用法

選擇的視圖包含您要在標記中預覽的文件:

命令調色板:

  • 從命令選項板中選擇“Markdown:使用Typora.app打開”(super+shift+p

菜單:

  • 選擇工具→使用Typora打開

控制TOC層級

關于在哪里放置這些CSS,請按照添加自定義CSS。

在Typora [TOC]中將生成“目錄”,默認情況下它將顯示h1~h6的標題。

例如,要隱藏低級標題h6,您可以附加CSS:

.md-toc-h6 {
  display: none;
}

在對焦模式下更改樣式

啟用聚焦模式時,<body>dom將具有類on-focus-mode,聚焦塊級元素將具有類md-focus。

可以包含md-focus類的塊是不能包含子塊的塊,并且將包含一個md-end-block類。例如,<blockquote>可以包含子塊<p>,因此它沒有md-end-block類,而h1具有該類。md-focus-containerclass將適用于li包含.md-focus塊的類。

所以我們可以在焦點模式下改變樣式,如:

/*Following are LESS code for better css structure*/

.on-focus-mode {
  /* under focus mode*/
  
  .md-end-block:not(.md-focus):not(.md-focus-container) {
    
    * {
      /* use color close to background for un-focused block */
      color: #C8C8C8 !important;
    }
    
    img{
      /* make img and element less attractive */
      opacity: 50%;
    }
  }
  
  .task-list-item:not(.md-focus-container)>input {
    /* make the check mark on task list less attractive*/
    opacity: 50%;
  }
  
  .md-fences.md-focus .CodeMirror-code>*:not(.CodeMirror-activeline) *,
  .CodeMirror.cm-s-inner:not(.CodeMirror-focused) * {
      /*lines in unfocused code fences, and unfocused lines in focused code fence*/
    color: #C8C8C8 !important;
  }
  
  li[cid]:not(.md-focus-container) {
    color: #C8C8C8 !important;
  }
  
  #typora-source .CodeMirror-code>*:not(.CodeMirror-activeline) * {
    /*source code mode under focus mode*/
    color: #C8C8C8 !important;
  }
  
  .md-focus,
  .md-focus-container {
    /* for text in current focused block */
    color: #111;
  }
 
}

添加搜索服務

用戶可以添加自定義搜索引擎以擴展上下文菜單中顯示的功能。

Slice 2.png

蘋果系統(tǒng)

在大多數(shù)應用程序的上下文菜單中,系統(tǒng)范圍內更改可用搜索引擎。你會在這里找到設置:

Snip20160815_11.png

Windows

(需要Typora≥v0.9.16)

  1. 在Typora中打開MenuPreference,然后單擊“打開高級設置”。
sshot-1.png
  1. 從打開的“文件瀏覽” 打開并編輯conf.user.json。如果沒有這樣的文件,請創(chuàng)建一個。

  2. 修改或設置以下配置到conf.user.json文件中,%s將代表所選文本。例如:

    "searchService": [
        ["Search with Google", "https://google.com/search?q=%s"],
        ["Translate", "http://translate.google.com/?source=osdd#auto|auto|%s"]
        ["Search with Wikipedia", "https://en.wikipedia.org/wiki/Special:Search/%s"]
      ]
    

    注意:默認配置是:

    "searchService": [
        ["Search with Google", "https://google.com/search?q=%s"],
      ]
    
  3. 重啟Typora,選項searchService將在上下文菜單中提供。

Shell或Cmd中使用

蘋果系統(tǒng)

您可以使用open -a typora xxx.md在Typora中打開目標markdown。如果Typora是.md文件的默認編輯器,那么open xxx.md就足夠了。

你也可以添加

alias typora="open -a typora"

在您的 .bash_profile 或其他配置文件中,您可以 typora xxx.md直接從shell /終端打開markdown文件。

Windows

如果將Typora設置為默認的markdown編輯器,則在cmd.exe中,.md直接輸入文件路徑將打開目標markdown文件。例如:.\example.mdstart example.md

要將Typora設置為默認的markdown編輯器,您必須執(zhí)行以下操作:

  1. 選擇一個markdown文件
  2. 打開上下文菜單并選擇
    • 單擊Properties,然后單擊Change buttong,如圖1所示
    • 打開 - >選擇其他應用程序如圖2所示
  3. “您想如何打開此文件 ”中選擇TyporaTypora Launcher ?并設置選中“ 始終使用此應用程序”以打開.md文件。

圖1 - 文件屬性窗口

Snip20180704_1.png

圖2 - 應用程序選擇器窗口

Snip20180704_2.png

Linux的

Linux上安裝Typora后,用戶可以typora直接在終端中運行,例如:

typora ~/Document/test.md

調整圖像大小 圖片

Typora允許使用<img>標簽顯示圖像,也可用于調整圖像的大小。

例如,您可以指定標記的屬性widthheight屬性<img>,或在其style屬性中設置寬度/高度:

<img src="https://www.google.com/doodles/kamma-rahbeks-241st-birthday" width="200px" />

<!--or-->

<img src="https://www.google.com/doodles/kamma-rahbeks-241st-birthday" style="height:200px" />

另一個常見的用例是,當您嘗試插入視網(wǎng)膜圖像,并希望將其縮放為“正確”大小時,您可以zoom在其style屬性中指定一個因子。

<img src="https://www.google.com/doodles/kamma-rahbeks-241st-birthday" style="zoom:50%" />

Typora可以理解和顯示上述語法。雖然您可以在其style屬性中設置其他css屬性,但在Typora編輯或預覽時會忽略它們,但可能會影響導出的HTML或PDF。

自動保存

macOS(Typora≥0.9.9.8.2)

在macOS上,操作系統(tǒng)將為基于文檔的應用程序(如Typora或TextEdit)安排自動保存操作。因此,“自動保存”始終作為系統(tǒng)功能啟用。

general.png

如果您希望Typora在退出或關閉時自動保存內容,而不彈出確認對話框,請取消選中復選框。

如果您希望Typora在重新啟動時恢復所有窗口/文檔,請取消選中復選框二。

Windows / Linux(Typora≥0.9.21)

Snip20161027_2.png

您可以在首選項面板上啟用此功能。

默認情況下,文檔將每5分鐘保存一次。

如果要更改時間間隔,請單擊首選項面板上的“打開高級設置”按鈕,這將彈出一個名為的文件夾conf,然后編輯或創(chuàng)建一個名為的文件conf.user.json,并修改/添加以下設置:

{
  "autoSaveTimer": 5 // Double, default is 5. The unit is "minute"
}

恢復未保存的草稿(Windows / Linux)

無論是否啟用“自動保存”選項,如果Typora退出或崩潰而未保存文件,或者您不小心保存了自己的文字,可以單擊“恢復未保存的草稿”按鈕以找到一些自動由Typora保存寫入的草稿。

這些備份草稿的文件名就像是{date}-{filename}.md,如果您的內容是新創(chuàng)建的,沒有文件路徑(即“無標題”),則該{filename}部分是自動生成的,通常是第一個標題或第一個句子。您可以找到并復制相應的備份文件以檢索您的部分文章。

版本控制和恢復

蘋果系統(tǒng)

在macOS上,Typora與操作系統(tǒng)支持的本機版本控制功能集成。

你可以簡單地選擇File> Revert To> Browse All Versions從主菜單瀏覽和回復到某個版本。更多細節(jié)可以在這里找到。

Snip20170228_6.png

在Windows / Linux的

Windows 10還具有系統(tǒng)級別的版本控制支持(參考)。

在Window / Linux上的Typora不提供版本控制功能,但可以及時保存草稿以防止數(shù)據(jù)丟失,當Typora退出或崩潰而不保存文件,或者您意外地完成Typora而不保存您的文字。

您可以打開首選項面板,在“編輯器”部分下,單擊“恢復未保存的草稿”按鈕,找到由Typora自動保存的一些書寫草稿。

Snip20170228_7.png

這些備份草稿的文件名就像是{date}-{filename}.md,如果您的內容是新創(chuàng)建的,沒有文件路徑(即“無標題”),則該{filename}部分是自動生成的,通常是第一個標題或第一個句子。您可以找到并復制相應的備份文件以檢索您的部分文章。

另外,Typora for Window / Linux具有自動保存功能。

RTL(從右到左)支持(實驗)

關于在哪里放置這些CSS,請按照添加自定義CSS。

這還沒有經(jīng)過全面測試,因為我不是RTL用戶,如果發(fā)現(xiàn)任何錯誤,請向hi@typora.io報告

添加以下自定義CSS:

#write {
    direction: rtl;
}

任務列表 - 記錄待辦事項的簡便方法

基本用法

鍵入以下標記,它們將呈現(xiàn)為任務列表。

- [ ] This task is incomplete.
- [x] This task is completed.

快速更改任務狀態(tài)的方法

只需單擊當前任務列表的復選框,或 -

選擇Paragraph→ 下的菜單項Task Status,如果需要,請按照自定義鍵綁定指定快捷鍵。

“刪除”已完成的任務

您可能希望像這樣自動在已完成的任務上添加刪除線


Snip20170824_1.png

這可以通過添加以下自定義CSS來實現(xiàn):

.task-list-done {
    /* styles for completed tasks */
    text-decoration: line-through;
}
.task-list-not-done {
    /* styles for incomplete tasks */
}

您還可以添加CSS以使完成的任務列表減少對比度,因此您可以添加類似于color: #777更改選擇器的文本顏色的內容.task-list-done。

關于在哪里放置這些CSS,請按照添加自定義CSS

自動配對

Snip20170824_4.png

正常自動配對

打開首選項面板,并啟用“自動配對括號和引號”(上圖中的第1項)以打開正常自動對,其行為與大多數(shù)代碼編輯器相同。

自動配對擴展字符

如果啟用了“自動對常見的markdown語法”,自動對行為也將被延長到markdown的符號,像*~,\``,或者_,如果“hightlight”,“內聯(lián)數(shù)學”,“上標”被啟用,自動配對的=,$并且^`也將被打開。

請注意,對于~,=^,結束對不會被自動插入,但是當你選擇一個單詞,并輸入字符,如=,那么這個詞將被包圍=自動。

分頁

自動分頁

有時您可能希望導出為PDF,并在頂級標題上設置分頁符。

打開themes文件夾,然后根據(jù)要包含的內容編輯css

@media print {
  h1 {
    page-break-before: always;
  }
  h1:first-of-type {
    page-break-before: avoid;
  }
}

現(xiàn)在導出時,將在每個h1元素之前創(chuàng)建一個新頁面,第一個元素除外。

強制分頁

要在文檔上插入強制分頁<div style="page-break-after: always;"></div>符,您可以在編寫時嘗試輸入HTML 。

嚴格模式

你可以啟用嚴格模式告訴Typora 更嚴格地遵循GFM的規(guī)范。如果希望解析器更具“容錯能力”,可以禁用它。

嚴格的模式

在嚴格模式下,如果要輸入標題,則必須在#字符后面加上空格(例如,·代表一個空格):

Markdown來源 嚴格模式結果 沒有嚴格模式的結果
###Header ###header header
###·Header header header

在嚴格模式下,如果要在列表項中創(chuàng)建新塊/段落,則必須輸入足夠的空格縮進以使新段落與其前一段嚴格對齊,例如(·表示一個空格):

嚴格模式 非嚴格模式
1.·aaa ··bbb // not in same list ``1.·aaa ···bbb // in same list ``10.·aaa ··1.·ccc // not a sub list ``10.·aaa ····1.·ccc // a sub list 1.·aaa ··bbb // in same list ``1.·aaa ···bbb // in same list ``10.·aaa ··1.·ccc // a sub list ``10.·aaa ··· 1.·ccc // a sub list

啟用/禁用嚴格模式

可以在Preference PanelMarkdown部分切換此選項。重新啟動Typora后將應用該選項。

改變書寫區(qū)域的寬度

下面的一些CSS樣式適用于最新版本的Typora(在macOS上> = 0.9.9.6,在Windows上> = 0.9.13)。*

關于在哪里放置這些CSS,請按照添加自定義CSS。

CSS示例:

#write {
  max-width: 1800px; /*adjust writing area position*/
}

您還可以使用其他css樣式padding-leftpadding-right調整書寫區(qū)域。

要更改源代碼模式的寬度:

#typora-source .CodeMirror-lines {
  max-width: auto; /*or 1000px*/
}

使用Typora / Markdown中的鏈接

基本語法

  • 超鏈接

    [Link Text](link-address)
    
    [Link Text](link-address "optional title")
    

    http://對于這種類型的語法,不能忽略類似的協(xié)議。

  • 參考鏈接

    [Link Text][Ref]
    
    [Ref]: link-address "optional title"
    

    或者,它可以縮短為

    [Ref][]
    
    [Ref]: link-address
    

    http://對于這種類型的語法,不能忽略類似的協(xié)議。

  • 自動鏈接

    <http://typora.io>
    
  • 自動網(wǎng)址:Typora可以自動檢測markdown中的網(wǎng)址鏈接,并將其呈現(xiàn)為網(wǎng)址鏈接,但請注意其他markdown引擎可能不支持此功能。

    This is a link: http://typora.io
    

對于指向網(wǎng)站的鏈接,我們建議您不要忽略https://http://類的URL協(xié)議,或者在導出/發(fā)布之后它可能是Typora或其他markdown引擎的相關鏈接。

鏈接到本地文件

您可以使用寫入相對或絕對路徑作為本地文件的鏈接地址,可以省略類似(.md)的擴展名,例如:

[Readme1](Readme1.md)

[Readme2](../Docs/Readme2.markdown)

[Readme3](Readme3)

[Readme4](/User/root/Docs/Readme1.md)

[Readme4](C:/Develop/Docs/Readme1.md)

[Readme4](file:///User/root/Docs/Readme1.md)

請注意,對于相對鏈接地址,當根據(jù)Markdown規(guī)范導出為HTML時,它不會轉換為真正的絕對文件路徑。

內部鏈接

您可以使用#創(chuàng)建標記文件中任何標題的鏈接,例如:

# This is a title

...
...
...


A [link](#this-is-a-title) to jump towards target header

在Typora中打開鏈接

您可以在Typora中的鏈接上使用command+click(macOS)或ctrl+click(Linux / Windows)跳轉到目標標題,或在Typora中打開它們,或在相關應用程序中打開它們。

常問問題

錯誤“無法打開位置/abc.com,您的意思是http://abc.com嗎?”在我嘗試打開鏈接時顯示

如果要鏈接到本地文件abd.com,請確保路徑正確。

如果要創(chuàng)建指向網(wǎng)站“abc.com”的鏈接,則需要使用URL方案或協(xié)議,例如使用[link](http://abc.com)

有時,如果使用autolink(<www.google.com>)或auto URL(www.google.com),則可以省略協(xié)議,但是這會在不同的Markdown編輯器/引擎中規(guī)定變量,因此我們建議您不要在任何情況下忽略協(xié)議,以減少兼容性問題。

空白和換行

Typora中的推薦做法

在Markdown中,換行符令人困惑,我們的建議是:

  • 使用Typora的默認設置。
  • 用Typora的混合視圖寫。
  • 按下Enter鍵插入新的段落,并避免插入新行。
  • 如果確實需要單個硬換行符,請使用以下語法:<br/>。

單個換行

單個換行在不同的Markdown引擎中的解析方式不同,CommonMark只會忽略它,換句話說,如果你寫:

line 1
line 2

它將呈現(xiàn)為

第1行第2行

但是其他markdown引擎可能會選擇保留它(比如GitHub中的問題輸入框),或提供是否保留它的選項。

在Typora中,我們提供了是否在首選項面板中保留它的選項,您可以選擇快速從菜單欄寫入時的行為。默認情況下,Typora將在編輯視圖中保留換行符,并在打印或導出時忽略它們。您可以在首選項面板中更改此選項。

空白

連續(xù)空格類似于單個換行,大多數(shù)Markdown引擎會忽略它們,例如CommonMark,

Four    whietspace in between

將被轉換為

<p>Four    whitespace in between</p>

而你只會看到

中間有四個空格

默認情況下,Typora將在編輯視圖中保留連續(xù)空格,并在打印或導出時忽略它們。您可以在首選項面板中更改此選項。

如果你想插入其他markdown引擎支持的連續(xù)空格,你可以

  • 轉義空白,在每個空格之前輸入\
  • 使用HTML實體&nbps;。

Typora中的Enter

在Markdown中,兩個換行符意味著在Typora中創(chuàng)建一個新段落,當您按下Enter鍵時,會創(chuàng)建一個新段落,如果切換到源代碼模式,則會插入兩個換行符,例如,

第1段

第2段

paragraph 1
(empty line)
paragraph 2

您可以通過按Shift+ Enter鍵在編輯視圖中顯式插入單個換行符。

markdown硬換行

Markdown提供了插入單個硬換行符的方法:

  • 插入兩個空格和一個換行符。
  • <br/>直接插入HTML標記。

幾乎所有Markdown引擎都會將它們解析為輸出中的硬換行符。

在Typora中更改相關設置

我們在菜單欄中提供相關設置Preference PanelEdit- > Whitespace and Line Breaks

智能標點符號(SmartyPants)

注意:YAML / code / math塊或源代碼模式中都會忽略Smart QuotesSmart Dashes。

智能引號

您可以從菜單欄或首選項面板中找到Smart Quotes選項。啟用后,Typora將'"轉換向彎引號。例如,如果您輸入:

"It's a 'word' in a quoted sentence."

它會變成:

“It’s a ‘word’ in a quoted sentence.”

在Windows / Linux版本中,您可以在“首選項”面板中找到更多引號對模式,例如“?abc?”等。

在MacOS版本,你可以設置在引號模式System PreferencesKeyboardText。如果更改,Typora將需要重新啟動才能應用它。

智能破折號

您可以從菜單欄或首選項面板中找到Smart Dashes選項。啟用后,Typora將-----轉換為–和—,...將被轉換為…。

注意:在MacOS中,如果選擇“輸入轉換”,-----都將被轉換成—,要輸入-- alt+-`將其輸入。這似乎是一個macOS規(guī)范,Typora也跟隨macOS。

轉義引號和破折號

您可以使用\"\-轉義引號和短劃線以防止它們進行轉換。

“轉換輸入”和“轉換時轉換”

這些選項控制標點符號的轉換方式。

啟用“ 在輸入時轉換”時,會在用戶鍵入時立即轉換引號和短劃線,并且轉換后的內容將保存在Markdown源代碼中。例如,如果啟用了智能破折號,并且在用戶輸入...之后,將進入編輯/預覽視圖和源代碼。用戶可以通過undo操作取消不正確的轉換。

啟用“ 在渲染轉換”時,當用戶輸入ASCII引號和短劃線時,原始ASCII將保存在源模式中,但在編輯/預覽視圖中,Typora會將它們渲染為彎引號或unicode破折號。

當用戶在YAML /代碼/數(shù)學塊或源代碼模式下輸入時,兩者都忽略轉換。

在解析中重新映射Unicode標點符號

當智能破折號的“輸入時轉換上”啟用后,如果用戶輸入``將變成<!— comments —>,因為--被轉換。

為了防止這種情況,Typora引入了這個選項。啟用后,Typora會將markdown語法的unicode替代品重新映射為ASCII格式,例如:

輸入 解析為
<!— comments —> <!-- comment -->
[圖片上傳失敗...(image-d8411c-1554297158859)][圖片上傳失敗...(image-d4d352-1554297158859)] [圖片上傳失敗...(image-7e3b54-1554297158859)]
---(水平線)
》 引用 > 引用
...

如果您的IME(輸入法引擎)無法直接輸入ASCII標點,這也會有所幫助。

在輸入時轉換啟用時,這個選項也將被自動啟用。

文字替換

Typora并不支持進一步文本替換規(guī)則(例如:->,或(C)?)。要做這個:

  • 在MacOS,我們建議您設置System PreferencesKeyboardText。并在Typora的菜單中啟用“文本替換”。然后Typora可以使用您的文本替換規(guī)則。
  • 在Windows / Linux上,我們建議您使用第三方應用程序來配置文本替換。您可以從此列表中進行選擇。

嵌入視頻,媒體或網(wǎng)頁內容

您可以使用<HTML>代碼在Typora中嵌入視頻/音頻或遠程Web內容。

目錄

視頻

您可以嵌入這樣的視頻:

<video src="xxx.mp4" />

或者將視頻文件拖放到Typora中,Typora會自動插入視頻。

Video路徑遵循與圖像相同的規(guī)則。因此,選項“盡可能使用相對路徑”和“圖像根路徑”也適用于<video>內容。

音頻

<video>相同,您可以使用<audio>標簽來嵌入音頻:

<audio src="xxx.mp3" />

嵌入Web內容

有些網(wǎng)站允許您將其內容嵌入到其他網(wǎng)頁中,其中大部分支持<iframe>,Typora也支持這些網(wǎng)頁。您可以按照他們的“共享”頁面/對話框,將他們的代碼粘貼到Typora中,例如:

<iframe height='265' scrolling='no' title='Fancy Animated SVG Menu' src='//codepen.io/jeangontijo/embed/OxVywj/?height=265&theme-id=0&default-tab=css,result&embed-version=2' frameborder='no' allowtransparency='true' allowfullscreen='true' style='width: 100%;'>See the Pen <a >Fancy Animated SVG Menu</a> by Jean Gontijo (<a >@jeangontijo</a>) on <a >CodePen</a>.
</iframe>

這將成為

<iframe height="265" scrolling="no" title="花式動畫SVG菜單" src="http://codepen.io/jeangontijo/embed/OxVywj/?height=265&theme-id=0&default-tab=css,result&embed-version=2" frameborder="no" allowtransparency="true" allowfullscreen="true" style="color: rgb(0, 0, 0); font-family: Merriweather, "PT Serif", Georgia, "Times New Roman", STSong, serif; font-size: medium; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 300; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255); text-decoration-style: initial; text-decoration-color: initial; width: 800px;"></iframe>

有些網(wǎng)站只提供基于Javascript的嵌入代碼,而不是<iframe>剪輯,例如:

<blockquote class="twitter-tweet"><p lang="en" dir="ltr">Sunsets don&#39;t get much better than this one over <a >@GrandTetonNPS</a>. <a >#nature</a> <a >#sunset</a> <a >pic.twitter.com/YuKy2rcjyU</a></p>&mdash; US Department of the Interior (@Interior) <a >May 5, 2014</a></blockquote>
<script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>

Typora僅支持一些基于腳本的共享代碼,這些內容/腳本也將在沙箱iframe中運行,無法訪問本地文件和寫入內容。

我們可以考慮允許用戶在將來的更新中為此類配置“ 白名單 ”。

PDF

目前只有macOS版本支持嵌入PDF文檔:

<iframe src="https://pdfobject.com/pdf/sample-3pp.pdf" style="height=800px;" />

黑暗模式

MacOS Mojave推出了“Dark Mode”,Typora也完全支持它。你可以用它來:

  1. 在macOS Mojave中打開“黑暗模式”
  2. 在Typora中選擇一個黑暗主題。

閱讀有關主題的更多信息或在主題庫中查找更多主題。

啟動選項

啟動typora時,您可以將默認操作設置為:

  • 打開新文件
  • 恢復上次關閉的文件夾
  • 恢復上次關閉的文件和文件夾
  • 打開自定義文件夾。

可以在首選項面板中設置此選項:

Screen Shot 2019-01-06 at 22.39.31.png

字數(shù)

字數(shù)統(tǒng)計顯示在狀態(tài)欄(Windows / Linux)或標題欄上(懸停時為macOS)。Typora還會計算行數(shù),字符和估計的閱讀時間。您可以單擊“字數(shù)”按鈕,在彈出式面板中顯示所有這些統(tǒng)計信息。


CleanShot 2019-01-04 at 01.08.13@2x-6535752.png

您可以通過選擇字數(shù)統(tǒng)計面板中的相應項來更改默認計數(shù)單位。

選擇一系列文本時,所選文本的字數(shù)或字符數(shù)將顯示在字數(shù)統(tǒng)計按鈕中。

字數(shù)不包括用于格式目的的markdown語法,例如list bullet( - ),而字符數(shù)計算它們。

對于中文文本,一個漢字算一個字。

對焦模式和打字機模式

對焦模式

啟用“對焦模式”時,Typora將淡出除當前行/塊之外的其他內容。您可以從view菜單中打開/關閉“對焦模式” 。

Focus Mode Focus Mode
Screen Shot 2019-01-05 at 15.50.26.png
Screen Shot 2019-01-05 at 15.50.48.png

打字機模式

打字機模式模仿機械打字機的行為 - 它滾動文章以在打字時保持當前插入符不變。

您可以從view菜單中打開/關閉打字機模式。

默認情況下,即使您通過鼠標單擊更改選擇,它也始終將插入符號保留在窗口中間。如果您只想在鍵入時使用固定滾動,則可以從preferences panel→ 禁用此行為Always keep caret in middle of screen\nwhen typewriter mode is enabled。

復制和粘貼

剪貼板如何工作

我們先來討論剪貼板格式。剪貼板格式用于描述剪貼板上放置的數(shù)據(jù)類型。

當您在Typora中復制內容時,在大多數(shù)情況下,Typora會將所選內容轉換為不同的格式,包括HTML,Rich Format(RTF),純文本,并將它們同時存儲在剪貼板中。然后,當您粘貼到不同的應用程序時,將根據(jù)目標應用程序的邏輯選擇正確的格式。例如,如果您粘貼到Gmail中,則會粘貼HTML格式的內容,而如果您粘貼到源代碼編輯器(如Sublime)中,則會粘貼純文本格式的內容。因此,與大多數(shù)其他Markdown編輯器不同,Typora不會明確提供“以HTML格式復制”或“復制為RTF”等菜單操作,當您在Typora中復制時,這些格式已經(jīng)被復制。

通常,您可以按下Command/Ctrl+Shift+V將內容作為純文本(或“匹配樣式”)粘貼到其他應用程序中。

同樣,當您將內容粘貼到Typora時,首先,Typora在剪貼板中選擇HTML格式并將其轉換為Markdown。如果未找到HTML內容,typora會將內容粘貼為純文本或Markdown源。在源代碼模式下,始終選擇純文本格式。

粘貼為純文本

“粘貼為純文本”與Typora中的“粘貼為markdown源”具有相同的含義。您可以使用快捷鍵Command/Ctrl+Shift+V。

復制為Markdown

如果您復制的內容看起來像“ 男孩 ”并粘貼到純文本編輯器,如Notepad.exe或VSCode,

默認情況下將粘貼“男孩”,而選擇“復制為markdown”時將粘貼“男孩”。這個快捷鍵是Command/Ctrl+Shift+C。

默認復制行為

如果您與豐富的編輯器(如郵件客戶端或Word)以及代碼編輯器或IDE一起工作,您可能希望 - 在Typora中復制內容,然后:

  • 粘貼到富編輯器時粘貼了豐富的內容
  • 粘貼到代碼編輯器時粘貼Markdown源代碼

這在其他markdown編輯器中很難實現(xiàn),但在Typora中完全可能。

要實現(xiàn)此目的,請打開首選項面板的“編輯器”選項卡/部分,然后為“默認復制行為”啟用“將標記源復制為純文本”。

Screen Shot 2019-01-24 at 22.48.12.png

在Typora中復制內容

Screen Shot 2019-01-24 at 22.55.13.png

粘貼到Gmail中(將粘貼具有豐富樣式的內容)

image-20190124225734855.png

粘貼到VSCode(將粘貼Markdown源代碼)

沒有主題樣式的復制

默認情況下,從其他富文本編輯器復制內容將包括樣式,包括字體,行高,顏色等。您可能只想復制具有基本格式或“語義文本”的內容。

例如,您可能希望復制<strong>text</strong>,而不是具有在每個主題中定義的特定字體系列,字體大小,顏色...樣式的“文本”,在這種情況下,“首選沒有主題樣式的復制”是首選。

Screen Shot 2019-01-24 at 23.07.32.png

復制沒有主題樣式并粘貼到頁面

為了更好地在Typora和其他應用程序之間移動內容,請使用“導出”功能而不是復制和粘貼。

復制為HTML代碼

當選擇動作時,Typora會將所選部分轉換為HTML,并將HMTL源代碼放入剪貼板的“純文本”格式。對于開發(fā)人員,您可能有機會在源代碼編輯器中編輯HTML文件,此菜單操作可幫助您將Typora中的內容復制到HTML源代碼中。

Screen Shot 2019-01-24 at 23.11.28.png

復制為HTML代碼并粘貼到VSCode中

使用移動設備和其他設備

數(shù)據(jù)同步

Typora以Markdown格式存儲文件,這只是純文本。因此,您可以使用任何第三方同步工具(例如iCloud Drive,Google Drive,OneDrive,Dropbox等)跨設備同步這些文件。

移動支持

我們目前專注于Typora的桌面版本,因此不久將不會有Typora的移動版本。

要在Mobile上編輯文件,您可以選擇支持iCould Drive或其他第三個云同步/存儲工具的任何Markdown編輯器,例如

  • Pretext
  • MWeb
  • 1Writer
  • ByWord
  • iA Writer
  • Editorial
  • ...或在App Store或Google Play中搜索“Markdown”。
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
【社區(qū)內容提示】社區(qū)部分內容疑似由AI輔助生成,瀏覽時請結合常識與多方信息審慎甄別。
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發(fā)布,文章內容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務。

相關閱讀更多精彩內容

友情鏈接更多精彩內容