AsciiDoc

AsciiDoc is a text document format for writing notes, documentation, articles, books, ebooks, slideshows, web pages, man pages and blogs.

AsciiDoc files can be translated to many formats including HTML, PDF, EPUB, man page.

以前一直使用 markdown 進行文字編輯，不過有時候 markdown 對複雜格式（例如表格、圖片標題）支援不夠，導致有很多分支。

今天無意間看到下面的標記語言，覺得更加健全成熟。

Quick Start

寫法

= Hello, AsciiDoc!
Doc Writer <[email protected]>

An introduction to http://asciidoc.org[AsciiDoc].

== First Section

* item 1
* item 2

[source,ruby]
puts "Hello, World!"

檔案字尾：使用 .adoc

特性

AsciiDoc 相比 Markdown 支援更多的格式，包括而不限於：

• 文件屬性，設定作者、版本資訊等。

• 語法高亮。

• 表格。

• Include 功能，將大文件拆分幾個檔案。

• 自定義塊語法，可擴充套件性。

ATOM

對於輕量級文字，使用任何的記事本即可。不過優秀的編輯器可以使得寫作更加愉悅高效。

ATOM is a hackable text editor for the 21st Century.

下載

首頁 點選下載即可。

安裝

MAC 系統的 atom-mac.zip 解壓後是一個 ATOM 執行程式。

如果想可以在應用程式中找到此程式，直接複製到應用程式中即可。

效果圖

直接開啟 mac terminal 命令列，輸入

apm install asciidoc-preview
 

日誌如下：

$ apm install asciidoc-preview
Installing asciidoc-preview to /Users/houbinbin/.atom/packages 
✓

然後重啟下編輯器，control+shift+a 可以開啟預覽。

測試環境

• MAC 版本

ProductName:    Mac OS X
ProductVersion: 10.13.1
BuildVersion:   17B1003

• ATOM 版本

Atom    : 1.24.0
Electron: 1.6.16
Chrome  : 56.0.2924.87
Node    : 7.4.0