Saya telah menemukan sejumlah sebutan dukungan MultiMarkdown untuk tautan internal / jangkar bernama tetapi saya tidak dapat menemukan contoh tunggal bagaimana sebenarnya melakukannya.
Jadi, apa sintaks untuk menunjukkan jangkar bernama, dan apa sintaks untuk menautkannya sama dengan menautkan ke URL lain (hanya menggunakan #foo alih-alih http://....
)?
markdown
multimarkdown
masukomi
sumber
sumber
Jawaban:
Dalam Penurunan standar, letakkan jangkar di
<a name="abcd"></a>
mana Anda ingin menautkan dan merujuknya pada halaman yang sama[link text](#abcd)
.(Ini menggunakan
name=
dan tidakid=
, karena alasan yang dijelaskan dalam jawaban ini .)Referensi jarak jauh dapat menggunakan
[link text](http://...#abcd)
tentu saja.Ini berfungsi seperti mimpi, asalkan Anda memiliki kendali atas sumber dan teks target. Jangkar bahkan dapat muncul dalam tajuk, dengan demikian:
menghasilkan:
Judul di entri SO ini!
dan kami bahkan dapat menautkannya jadi:
(Pada SO, tautannya tidak berfungsi karena jangkar dilepaskan.)
sumber
<a id="id"></a>
formulir terbaik. Lihat pertanyaan / jawaban SO ini .name=
sudah usang dalam XHTML, tapi sekarang saya menemukan ituid=
memiliki efek samping dalam HTML5, jadi saya kembali kename=
jawaban ini.Jika Anda memiliki header dalam file penurunan harga, Anda dapat langsung menautkannya dalam file tersebut.
Head Markdown -
## The Header
ini akan menghasilkan id implisit
#the-header
(ganti spasi internal dengan tanda hubung dan buat huruf kecil).Untuk menavigasi ke id ini, Anda dapat membuat tautan seperti ini:
[Link to Header](#the-header)
Ini setara dengan:
<a href="#the-header">Link to Header</a>
Harap dicatat nama referensi adalah huruf kecil
#header
.sumber
## This Header ##
, tautannya adalah[To This Header](#markdown-header-this-header)
. Jika Anda tidak yakin apa id dari header Anda, gunakan pemeriksa halaman untuk melihat nilai-nilai HTML.[Link](user-content-the-header)
Diambil dari Panduan Pengguna Multimarkdown (terima kasih kepada @MultiMarkdown di Twitter karena menunjukkannya)
[Some Text][]
akan menautkan ke tajuk yang bernama "Some Text"misalnya
Label opsional yang Anda pilih untuk membantu menyamaratakan kasus di mana beberapa tajuk memiliki judul yang sama:
sumber
Saya menguji Github Flavour Markdown untuk sementara waktu dan dapat meringkas dengan empat aturan:
-
Misalnya, jika bagian Anda diberi nama ini:
Buat tautan dengan cara ini:
sumber
Cara terbaik untuk membuat tautan internal (terkait dengan bagian) adalah membuat daftar tetapi alih-alih tautan, letakkan #section atau # section-title jika header menyertakan spasi.
---- MARKDOWN ------------------------
---- PREVIEW DAFTAR ------------------------
---- HTML ------------------------
Tidak masalah apakah itu tajuk h1, h2, h3, dll., Anda selalu merujuknya menggunakan hanya satu
#
.Semua referensi dalam daftar bagian harus dikonversi ke teks huruf kecil seperti yang ditunjukkan pada contoh di atas.
Tautan ke bagian harus huruf kecil.Dengan cara lain itu tidak akan berhasil.
Teknik ini bekerja sangat baik untuk semua varian Markdown, juga MultiMarkdown.
Saat ini saya menggunakan Pandoc untuk mengonversi format dokumen. Ini jauh lebih baik daripada MultiMarkdown.
Uji Pandoc di sini
sumber
## Hello
Anda harus menyebutnya sebagai[Whatever you want](#Hello)
Di mdcharm seperti ini:
sumber
Ini solusi saya (didapat dari
SaraubhM
jawaban)**Jump To**: [Hotkeys & Markers](#hotkeys-markers) / [Radii](#radii) / [Route Wizard 2.0](#route-wizard-2-0)
Yang memberi Anda:
Langsung ke : Hotkeys & Marker / Radii / Route Wizard 2.0
Catat perubahan dari
dan
.
ke-
dan juga hilangnya&
tautan.sumber