Tập tin nào sử dụng phần mở rộng .md và tôi nên chỉnh sửa chúng như thế nào?


878

Trên GitHub, một số dự án có README.mdtệp. Có vẻ như một tập tin định dạng đơn giản để thể hiện văn bản và hình ảnh.

Tôi đoán có một biên tập viên hoặc giải thích cú pháp ở đâu đó.

Tôi có thể tìm thấy phần giới thiệu về .mdtập tin ở đâu?


38
Tôi đoán đây là bằng chứng ủng hộ việc sử dụng .markdownphần mở rộng thay vào đó, mặc dù nó rất kinh khủng dài ...
endolith

7
Đây là một liên kết có thể giúp bạn -> Phần mở rộng tệp .MD
Vipin Kr. Singh

1
MarkPad là một ứng dụng hay để chỉnh sửa MarkDown trong Windows. Nó trình bày cho bạn bản xem trước của các chỉnh sửa.
skjoshi

1
Người dùng có thể dùng thử MarkView , tiện ích mở rộng của Chrome để chỉnh sửa và xem tệp đánh dấu bên trong trình duyệt.
swcool

1
Hướng dẫn đầy đủ để giúp bạn bắt đầu với markdown: blog.wax-o.com/2014/04/ . Bạn nên cố gắng viết markdown với cách trực quan hóa kết quả (với một ứng dụng như mouapp.com ). Bạn có biết rằng cú pháp bình luận và cú pháp stackoverflow dựa trên markdown không? :) stackoverflow.com/editing-help
fabien 04/07 '

Câu trả lời:


733

Markdown là một định dạng tệp văn bản đơn giản. Các phần mở rộng .md.markdownchỉ là các tệp văn bản được viết theo cú pháp Markdown . Nếu bạn có Readme.mdtrong repo của mình, GitHub sẽ hiển thị nội dung trên trang chủ của repo của bạn. Đọc tài liệu:

Bạn có thể chỉnh sửa Readme.mdtệp trong GitHub. Nhấp vào Readme.md, bạn sẽ tìm thấy nút chỉnh sửa. Bạn có thể xem trước các thay đổi của mình và thậm chí cam kết chúng từ đó.

Vì nó là một tệp văn bản, Notepad hoặc Notepad ++ (Windows), TextEdit (Mac) hoặc bất kỳ trình soạn thảo văn bản nào khác có thể được sử dụng để chỉnh sửa và sửa đổi nó. Các trình soạn thảo chuyên dụng tồn tại tự động phân tích cú pháp đánh dấu khi bạn nhập nó và tạo một bản xem trước, trong khi các trình soạn thảo khác áp dụng các màu cú pháp và trang trí khác nhau cho văn bản được hiển thị. Trong cả hai trường hợp, tệp đã lưu vẫn là tệp văn bản có thể đọc được.

Nếu bạn muốn tạo một mdtệp có bản xem trước và nếu bạn không muốn cài đặt bất kỳ trình soạn thảo đặc biệt nào, bạn có thể sử dụng các trình soạn thảo trực tuyến như dillinger.iostackedit.io . Họ cung cấp xem trước trực tiếp. Bạn cũng có thể xuất các tệp của mình sang Google Drive hoặc Dropbox .


27
Tôi thấy lời giải thích cơ bản của Github cũng rất hữu ích khi giới thiệu nhanh.
Voo

2
Trên Windows, bạn có thể muốn sử dụng Wordman để sử dụng định dạng để dễ đọc hơn.
G O'Rilla

4
@ GO'Rilla, IMHO tránh các bản nhạc giống như bệnh dịch trừ khi viết những ghi chú nhỏ cho chính mình mà bạn sẽ không bao giờ chia sẻ với bất kỳ ai. Những gì nó thêm vào tệp .txt có thể tàn phá các trình soạn thảo khác (vim, Notepad ++, v.v.). Tốt hơn nhiều để làm việc trong văn bản thuần khi xử lý .txt và sử dụng trình xử lý văn bản hoặc Acrobat cho các tệp văn bản không .txt như .doc và .pdf.
mê cung

1
chúng ta có thể thêm hình ảnh hoặc thông qua liên kết trong tệp .md ... có được không?
Raphael

1
@ user1645290 Vâng, điều đó là có thể. xem
B-GangsteR

87

Nếu bạn đang tìm kiếm một trình soạn thảo, tôi khuyên bạn nên sử dụng http://dillinger.io/ . Nó là một trình soạn thảo văn bản dựa trên trình duyệt đơn giản có thể khiến Markdown nhanh chóng.

Tuy nhiên, nếu bạn thích một ứng dụng và bạn đang sử dụng OS X, bạn có thể dùng thử Mou . Nó là khá tốt và đầy đủ các ví dụ.


2
Dường như được sống lại?
GuiSim

5
Tôi muốn đề xuất http://dillinger.io/ , một trình soạn thảo văn bản dựa trên trình duyệt thực sự thú vị khác. Nó cũng cho phép bạn liên kết Dropbox, Github và Google drive.
sirLisko

Liên kết Notepad trong câu trả lời này kích hoạt tải xuống tệp RAR. Tại sao không có trang web, bạn không nói đó là trình chỉnh sửa dựa trên trình duyệt?
evanrmurphy

liên kết đó không còn hiệu lực
Carlos Pliego

Chỉ cần chỉ ra rằng đây không phải là một câu trả lời đầy đủ cho câu hỏi. Bạn không giải thích .md là gì, chỉ có thể chỉnh sửa nó như thế nào
Zoe


33

Trình soạn thảo văn bản Visual Studio Code của Microsoft đã tích hợp hỗ trợ cho các tệp .md được viết theo cú pháp đánh dấu.

Cú pháp được tự động mã hóa màu bên trong tệp .md và có thể xem cửa sổ xem trước của đánh dấu kết xuất bằng cách nhấn Shift+Ctrl+V(Windows) hoặc Shift+Cmd+V(Mac).

Để xem chúng cạnh nhau, hãy kéo tab xem trước sang bên phải trình chỉnh sửa hoặc sử dụng Ctrl+K V(Windows) hoặc Cmd+K V(Mac) thay thế.

nhập mô tả hình ảnh ở đây

Mã VS sử dụng thư viện được đánh dấu để phân tích cú pháp và có hỗ trợ Github Flavored Markdown được bật theo mặc định, nhưng nó sẽ không hiển thị nội tuyến Github Emoji như trình soạn thảo văn bản Atom của Github .

Ngoài ra, hỗ trợ VS Code có sẵn một số plugin đánh dấu cho chức năng mở rộng.


Nếu bạn đang sử dụng Visual Studio 2015 thay vào đó hãy xem câu trả lời của tôi dưới đây.
bytedev

1
Lưu ý - bạn có thể nhấp chuột phải vào tệp readme> xem trước mở
Chris Halcrow

15

Tiện ích mở rộng ' .md ' đề cập đến các tệp Markdown .

Nếu bạn không muốn cài đặt một ứng dụng để đọc chúng ở định dạng đó, bạn chỉ cần sử dụng TextEdit hoặc Xcode để mở nó trên Mac.

Trên bất kỳ HĐH nào khác, bạn sẽ có thể mở nó bằng bất kỳ trình soạn thảo văn bản nào , mặc dù như mong đợi, bạn sẽ không thấy nó ở định dạng Markdown .


4
Trên thực tế, bạn sẽ thấy nó ở định dạng Markdown. Mặc dù vậy, bạn sẽ không thấy nó là chữ in đậm, chữ nghiêng, thụt lề và khối mã.
Các cuộc đua nhẹ nhàng trong quỹ đạo

14

Yup, chỉ là GitHub có hương vị Markdown . Bao gồm tệp README trong kho lưu trữ của bạn sẽ giúp người khác nhanh chóng xác định nội dung và cách cài đặt tệp. Rất hữu ích để bao gồm trong repos của bạn.


5
Bị hạ bệ. Bởi một trong những người khác, trong đó có một người trong kho lưu trữ của bạn, bạn có nghĩa là một tập tin README ở bất kỳ định dạng nào, không chỉ là một tập tin README.md. Nhưng câu hỏi là hỏi về các tập tin .md, nói chung, không phải về các README nói chung. Vì vậy, câu trả lời này không liên quan đến câu hỏi. Ngoài ra, sự mơ hồ với một trong những người có thể khiến người đọc nghĩ rằng Markdown READMEs nhất thiết phải tốt hơn các README khác, điều đó là sai.
Rory O'Kane

1
Tôi đã thực hiện thay đổi được chỉ định trong nhận xét trước đó, bởi vì nó có ý nghĩa và tôi nghĩ rằng nó có thể giúp tránh nhầm lẫn. Tuy nhiên, tôi không nghĩ rằng đây là một câu trả lời hay, vì nó không bổ sung gì mới. Câu hỏi này không phải về README, nó là về phần mở rộng .md. Không có lý do để thêm câu trả lời này sáu tuần sau khi câu trả lời được chấp nhận cung cấp thông tin tương tự.
Erick Robertson


5

Markdown chỉ là một tệp văn bản tùy chọn có .mdhoặc .markdownphần mở rộng. Nó có thể được chuyển đổi sang HTML. Để biết cú pháp của Markdown, hãy xem

GitHub Hương vị Markdown .

Bạn có thể sử dụng bất kỳ trình soạn thảo văn bản để đánh dấu. Nếu bạn là sublime textngười dùng, bạn có thể kiểm tra Markdown Previewplugin sẽ hiển thị nội dung đánh dấu được hiển thị trong trình duyệt và cập nhật bất cứ khi nào bạn thay đổi tệp đánh dấu.

Một số trình soạn thảo markdown trực tuyến



3

Tôi đề nghị StackEdit . Nó là trình soạn thảo WISIWIG đơn giản. Bạn có thể sử dụng cả cú pháp biên tập và đánh dấu. Có một cú pháp đánh dấu trợ giúp nhanh chóng ở đó. Hoàn tác / làm lại, nhận xét, kết nối GoogleDrive, Dropbox.




2

Nếu bạn đang tạo tệp .md cho các giải pháp .NET của mình, tôi khuyên dùng phần mở rộng Mark Studio Editor của Visual Studio 2015 vì nó có bảng xem trước để bạn có thể thấy các thay đổi của mình trong thời gian thực.

EDIT : Điều này cũng sẽ hoạt động với Visual Studio 2017.


0

Cách dễ nhất để làm, nếu bạn không có trình đọc, là mở tệp MD bằng trình soạn thảo văn bản và sau đó viết tệp MD ra dưới dạng tệp HTML và sau đó nhấp đúp để xem bằng trình duyệt.


Điều này sẽ chỉ hoạt động nếu bạn có một plugin đọc các tệp .md.
Brad Bruce

0

.Md là viết tắt của Markdown Text. Về cơ bản, nó chỉ là một loại tệp văn bản khác, như .txt

Tôi sử dụng Notepad ++ để đọc và chỉnh sửa chúng

Khi sử dụng trang web của chúng tôi, bạn xác nhận rằng bạn đã đọc và hiểu Chính sách cookieChính sách bảo mật của chúng tôi.
Licensed under cc by-sa 3.0 with attribution required.