Bạn có thể nhúng Markdown vào HTML không?

Có rất nhiều lý do để thích Markdown, một ngôn ngữ đơn giản với cú pháp dễ học có thể được sử dụng với bất kỳ trình soạn thảo văn bản nào. Sử dụng các công cụ như Pandoc, bạn có thể chuyển đổi văn bản Markdown sang nhiều định dạng phổ biến, bao gồm cả HTML. Bạn cũng có thể tự động hóa quá trình chuyển đổi đó trong máy chủ web. Một ứng dụng HTML5 và JavaScript có tên MDwiki, được tạo bởi Timo Dörr, có thể lấy một chồng tệp Markdown và biến chúng thành một trang web khi được yêu cầu từ trình duyệt. Trang web MDwiki bao gồm hướng dẫn cách thực hiện và thông tin khác để giúp bạn bắt đầu

Bên trong máy chủ web, một trang MDwiki cơ bản trông như thế này

Tôi đã đổi tên tệp HTML MDwiki START.HTML cho dự án này. Ngoài ra còn có một tệp Markdown xử lý điều hướng và tệp JSON để chứa một vài cài đặt cấu hình. Mọi thứ khác là nội dung trang web

Mặc dù thiết kế tổng thể của trang web đã được MDwiki sửa khá nhiều, nhưng nội dung, kiểu dáng và số lượng trang thì không. Bạn có thể xem tuyển tập các trang khác nhau do MDwiki tạo tại trang MDwiki. Công bằng mà nói, các trang MDwiki thiếu sự hấp dẫn về mặt hình ảnh mà một nhà thiết kế web có thể đạt được—nhưng chúng vẫn có chức năng và người dùng nên cân bằng giữa vẻ ngoài đơn giản của chúng với tốc độ và sự dễ dàng tạo cũng như chỉnh sửa chúng.

Markdown có nhiều hương vị khác nhau giúp mở rộng chức năng cốt lõi ổn định cho các mục đích cụ thể khác nhau. MDwiki sử dụng Markdown hương vị GitHub, bổ sung các tính năng như khối mã được định dạng và tô sáng cú pháp cho các ngôn ngữ lập trình phổ biến, làm cho nó rất phù hợp để tạo tài liệu và hướng dẫn chương trình

MDwiki cũng hỗ trợ cái mà nó gọi là "mánh lới quảng cáo", bổ sung thêm chức năng như nhúng nội dung video YouTube và hiển thị các công thức toán học. Đây là những giá trị khám phá nếu bạn cần chúng cho các dự án cụ thể. Tôi thấy MDwiki là một công cụ lý tưởng để tạo tài liệu kỹ thuật và tài nguyên giáo dục. Tôi cũng đã phát hiện ra một số mánh khóe và thủ thuật có thể không rõ ràng ngay lập tức

MDwiki hoạt động với bất kỳ trình duyệt web hiện đại nào khi được triển khai trong máy chủ web; . Hầu hết người dùng MDwiki sẽ chọn triển khai các dự án đã hoàn thành trên máy chủ web để tránh loại trừ những người dùng tiềm năng, nhưng việc phát triển và thử nghiệm có thể được thực hiện chỉ với trình soạn thảo văn bản và Firefox. Các dự án MDwiki đã hoàn thành được tải vào Môi trường học tập ảo Moodle [VLE] có thể được đọc bởi bất kỳ trình duyệt hiện đại nào, điều này có thể hữu ích trong bối cảnh giáo dục. [Điều này có lẽ cũng đúng với các phần mềm VLE khác, nhưng bạn nên kiểm tra điều đó. ]

Phối màu mặc định của MDwiki không phải là lý tưởng cho tất cả các dự án, nhưng bạn có thể thay thế nó bằng một chủ đề khác được tải xuống từ Bootswatch. com. Để thực hiện việc này, chỉ cần mở tệp HTML MDwiki trong trình chỉnh sửa, lấy mã extlib/css/bootstrap-3.0.0.min.css và chèn chủ đề Bootswatch đã tải xuống. Ngoài ra còn có một mánh lới quảng cáo MDwiki cho phép người dùng chọn một chủ đề Bootswatch để thay thế chủ đề mặc định sau khi MDwiki tải trong trình duyệt của họ. Tôi thường làm việc với những người dùng khiếm thị và họ có xu hướng thích các chủ đề có độ tương phản cao, với chữ trắng trên nền tối

MDwiki, tệp Markdown và hình ảnh tĩnh phù hợp với nhiều mục đích. Tuy nhiên, đôi khi bạn có thể muốn đưa vào, chẳng hạn như trình chiếu JavaScript hoặc biểu mẫu phản hồi. Các tệp Markdown có thể bao gồm mã HTML, nhưng việc trộn Markdown với HTML có thể gây nhầm lẫn. Một giải pháp là tạo tính năng bạn muốn trong tệp HTML riêng và hiển thị tính năng đó bên trong tệp Markdown bằng thẻ iframe. Tôi lấy ý tưởng này từ Twine Cookbook, một trang web hỗ trợ cho công cụ viễn tưởng tương tác Twine. Twine Cookbook không thực sự sử dụng MDwiki, nhưng việc kết hợp các thẻ Markdown và iframe sẽ mở ra nhiều khả năng sáng tạo

Đây là một ví dụ

HTML này sẽ hiển thị một trang HTML được tạo bởi công cụ viễn tưởng tương tác Twine bên trong tệp Markdown

Kết quả trong một trang web do MDwiki tạo ra trông như thế này

Tóm lại, MDwiki là một ứng dụng nhỏ tuyệt vời đạt được mục đích của nó cực kỳ tốt

Đọc gì tiếp theo

Thẻ

soạn thảo văn bản

Công cụ

cổ vũ Peter

Tôi bắt đầu cuộc sống với tư cách là một nhà khảo cổ học trước khi đào tạo lại về CNTT và có nhiều kinh nghiệm làm việc trong lĩnh vực tự nguyện/phi lợi nhuận và giáo dục thường xuyên ở Scotland, nơi tôi thường làm việc. Điều này đã bao gồm thiết kế cơ sở dữ liệu, hỗ trợ phần cứng, hỗ trợ phần mềm, thiết kế trang web và học phí

Thêm về tôi