markdown-it-cjk-breaks

k_taka's additional features

Punctuation spacing options

Fine-tune the trigger list with spaceAfterPunctuationTargets. Provide either a single string or an array and every exact match becomes eligible for automatic spacing; this option replaces the defaults. Defaults remain ['！', '？', '⁉', '！？', '？！', '!?', '?!', '.', ':']. To disable punctuation spacing while still setting spaceAfterPunctuation, pass spaceAfterPunctuationTargets: [] (or null/false). Use spaceAfterPunctuationTargetsAdd to append triggers and spaceAfterPunctuationTargetsRemove to drop items from the resolved list.

Use spaceAfterPunctuation to inject a space every time this plugin suppresses a line break after punctuation. Accepts 'half' for ASCII space, 'full' for an ideographic space, or any custom string via a literal value.

import MarkdownIt from 'markdown-it';
import cjkBreaks from '@peaceroad/markdown-it-cjk-breaks-mod';

// Full-width spacing after default punctuation
const mdFull = MarkdownIt({ html: true }).use(cjkBreaks, {
  spaceAfterPunctuation: 'full',
  either: true
});
mdFull.render('こんにちは！\nWorld');
// <p>こんにちは！　World</p>

// Half-width spacing for ASCII-friendly mixes
const mdHalf = MarkdownIt({ html: true }).use(cjkBreaks, {
  spaceAfterPunctuation: 'half',
  either: true
});
mdHalf.render('こんにちは！\nWorld');
// <p>こんにちは！ World</p>

// Custom punctuation triggers
const mdCustom = MarkdownIt({ html: true }).use(cjkBreaks, {
  spaceAfterPunctuation: 'half',
  spaceAfterPunctuationTargets: ['??']
});
mdCustom.render('Hello??\nWorld');
// <p>Hello?? World</p>

Softbreak normalization for other plugins

Even with stock markdown-it, emphasis markers can leave inline text tokens that still embed \n. When normalizeSoftBreaks: true, those tokens are split back into proper softbreak entries before CJK suppression runs, so a trailing ***漢***\n字 behaves the same way regardless of how markdown-it represented it internally.

// Normalize softbreaks emitted by other plugins first
const mdStrongJaFriendly = MarkdownIt({ html: true }).use(cjkBreaks, {
  normalizeSoftBreaks: true,
  either: true
});
mdStrongJaFriendly.render('**漢**\nb');
// <p><strong>漢</strong>b</p>

@peaceroad/markdown-it-strong-ja also emit newline-containing text nodes after their own rewrites. The same option keeps behavior consistent no matter which order you register plugins.

sup39's additional features

• @sup39/markdown-it-cjk-breaks

Provide an optional option either(default: false, which works as original version) to determine whether allowing removing linebreak when either the character before OR after the linebreak is east asian character.

var md = require('markdown-it')();
var cjk_breaks = require('markdown-it-cjk-breaks');

md.use(cjk_breaks, {either: true}); // << set either to true

md.render(`
あおえ
うい
aoe
ui
`);

// returns:
//
//<p>あおえういaoe <!-- linebreak between `い` and `a` is removed -->
//ui</p>

Original

• markdown-it-cjk-breaks

Plugin for markdown-it that suppresses linebreaks between east asian characters.

Normally newlines in a markdown text get rendered as newlines in output html text. Then browsers will usually render those newlines as whitespace (more smart behavior is included in w3c drafts, but not actually implemented by vendors).

This plugin finds and removes newlines that cannot be converted to space, algorithm matches CSS Text Module Level 3:

• If the character immediately before or immediately after the segment break is the zero-width space character (U+200B), then the break is removed, leaving behind the zero-width space.
• Otherwise, if the East Asian Width property [UAX11] of both the character before and after the segment break is F, W, or H (not A), and neither side is Hangul, then the segment break is removed.
• Otherwise, the segment break is converted to a space (U+0020).

Install

yarn add markdown-it-cjk-breaks

Usage

var md = require('markdown-it')();
var cjk_breaks = require('markdown-it-cjk-breaks');

md.use(cjk_breaks);

md.render(`
あおえ
うい
aoe
ui
`);

// returns:
//
//<p>あおえうい
//aoe
//ui</p>

License

• markdown-it/markdown-it-cjk-breaks: MIT
• @sup39/markdown-it-cjk-breaks: MIT
• @peaceroad/markdown-it-cjk-breaks-mod: MIT