From 170226d2869743c503296169d40eb12c25c19a08 Mon Sep 17 00:00:00 2001 From: othree Date: Mon, 21 Mar 2011 17:35:50 +0800 Subject: [PATCH 1/5] remove nav --- basics.md | 9 --------- 1 file changed, 9 deletions(-) diff --git a/basics.md b/basics.md index 87c6ff5..2c1a06e 100644 --- a/basics.md +++ b/basics.md @@ -1,15 +1,6 @@ Markdown: Basics ================ - - - Getting the Gist of Markdown's Formatting Syntax ------------------------------------------------ From b7fb433472ce542e76d6d0a26465738649cc2b65 Mon Sep 17 00:00:00 2001 From: othree Date: Tue, 22 Mar 2011 12:30:44 +0800 Subject: [PATCH 2/5] basic intro --- basics.md | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/basics.md b/basics.md index 2c1a06e..c5bb5b9 100644 --- a/basics.md +++ b/basics.md @@ -11,16 +11,25 @@ looking at a few examples of it in action. The examples on this page are written in a before/after style, showing example syntax and the HTML output produced by Markdown. +這頁提供了 Markdown 簡單的概觀給想使用的人， [語法說明][s] 頁提供了 +完整詳細的文件，說明每項功能，但是 Markdown 其實很簡單就可以上手， +這頁文件提供了一些範例，並且每個範例都有提供輸出的 HTML 結果。 + It's also helpful to simply try Markdown out; the [Dingus] [d] is a web application that allows you type your own Markdown-formatted text and translate it to XHTML. +其實直接試試看也是一個很不錯的方法， [Dingus][d] 是一個網頁應用程式， +讓你可以把你的 Markdown 文件轉成 XHTML。 + **Note:** This document is itself written using Markdown; you can [see the source for it by adding '.text' to the URL] [src]. - [s]: /projects/markdown/syntax "Markdown Syntax" - [d]: /projects/markdown/dingus "Markdown Dingus" - [src]: /projects/markdown/basics.text +**Note:** 這份文件本身也是用 Markdown 寫的，你也可以看看 [它的原始碼][src] + + [s]: http://markdown.tw "Markdown Syntax" + [d]: http://daringfireball.net/projects/markdown/dingus "Markdown Dingus" + [src]: https://github.com/othree/markdown-syntax-zhtw/blob/master/basics.md ## Paragraphs, Headers, Blockquotes ## From 4722a277bab1f89a8bd7155cbe32d0b2317ecbb2 Mon Sep 17 00:00:00 2001 From: othree Date: Tue, 22 Mar 2011 13:12:01 +0800 Subject: [PATCH 3/5] basic part1 --- basics.md | 28 ++++++++++++++++++++++++++++ syntax.md | 2 +- 2 files changed, 29 insertions(+), 1 deletion(-) diff --git a/basics.md b/basics.md index c5bb5b9..4104cc4 100644 --- a/basics.md +++ b/basics.md @@ -40,6 +40,10 @@ a blank line -- a line containing nothing but spaces or tabs is considered blank.) Normal paragraphs should not be indented with spaces or tabs. +一個段落是由一個以上的連接的行句組成，而一個以上的空行則會切分出不同的段落 +（空行的定義是顯示上看起來像是空行，就被視為空行，例如有一行只有空白和 tab， +那該行也會被視為空行），一般的段落不需要用空白或斷行縮排。 + Markdown offers two styles of headers: *Setext* and *atx*. Setext-style headers for `

` and `

` are created by "underlining" with equal signs (`=`) and hyphens (`-`), respectively. @@ -47,8 +51,14 @@ To create an atx-style header, you put 1-6 hash marks (`#`) at the beginning of the line -- the number of hashes equals the resulting HTML header level. +Markdown 支援兩種標題的語法，[Setext] [1] 和 [atx] [2] 形式。 +Setext 形式是用底線的形式，利用 `=` （最高階標題）和 `-` （第二階標題）， +Atx 形式在行首插入 1 到 6 個 `#` ，對應到標題 1 到 6 階。 + Blockquotes are indicated using email-style '`>`' angle brackets. +區塊引言則使用 email 形式的 '`>`' 角括號。 + Markdown: A First Level Header @@ -75,6 +85,8 @@ Markdown: Output: +輸出： +

A First Level Header

A Second Level Header

@@ -102,6 +114,8 @@ Output: Markdown uses asterisks and underscores to indicate spans of emphasis. +Markdown 使用星號和底線來標記需要強調的區段。 + Markdown: Some of these words *are emphasized*. @@ -126,24 +140,33 @@ Unordered (bulleted) lists use asterisks, pluses, and hyphens (`*`, `+`, and `-`) as list markers. These three markers are interchangable; this: +無序清單使用星號、加號和減號來做為清單的項目標記，這些符號是都可以使用的， +使用星號： + * Candy. * Gum. * Booze. this: +加號： + + Candy. + Gum. + Booze. and this: +和減號 + - Candy. - Gum. - Booze. all produce the same output: +都會輸出： +